Documentation

Complete setup guides, commands, and configuration examples for all Armageddon Bot features.

Getting Started

Follow this comprehensive guide to set up Armageddon on your server. First, you must obtain a Whitelist to invite the bot.

Obtaining Whitelist

To get whitelisted, please open a ticket in our support server.

Join Support Server
Administrator Required

You must have Administrator permissions to run setup commands.

Requirements

Before you begin, ensure you meet these prerequisites.

Administrator permissions in your Discord server
Bot whitelist obtained from support server
Manage Roles, Manage Channels, and Manage Messages permissions for the bot

Verification System

The verification system requires users to authenticate via interactive modal interactions with a 6-digit code.

Setup Instructions

1

Initialize

Use /setup_verification as an administrator

2

Define Roles

Set Role IDs to be assigned and removed (comma-separated)

3

Set Channel

Define the text channel for verification prompt

How It Works

Users click the "Verify" button in the channel
Bot generates a 6-digit code and displays a modal
Users have 30 seconds to enter the correct code
Upon success, roles are assigned/removed as configured
Example /setup_verification 123456789,0987654321 02587413
Permissions Required

The bot requires Manage Roles permission. Verification codes expire after 30 seconds.

Ticket System

Allow users to open support tickets via a clean interface. Each ticket creates a dedicated private channel.

Configuration

Use /setup_ticket to configure the system with the following options:

Ticket Message: Embed title
Image URL: Embed image (or [skip])
Delete Channel ID: Archive destination
Dropdown Options: Up to 6 options (Emoji, Label, Description, Category ID, Custom Message, Delete Role ID)

Ticket Controls

Inside each ticket channel, an embed provides these controls:

Button Action
❌ Delete Close ticket and send transcript
➕ Add User Add a user to the ticket
➖ Remove User Remove a user from the ticket
Example /setup_ticket "Support" http://img.url 02587413 "📞,Support,Request Support" "Thanks for opening a ticket" "Thank you for closing the ticket"

Advanced Moderation

Automatic message checking, violation handling, and advanced filter configurations.

System Configuration

Command Description
!configure enabled true Enable all filters
!configure delete_dots true Auto-delete special character messages
!configure delete_invites true Auto-delete Discord invites
!configure notify_message "text" Set notification message
!configure whitelist #channel Add channel to whitelist
!configure role @RoleName Set violation role
/purge_messages [limit] Mass delete messages

Auto-Delete Features

Messages with only special symbols
Discord invites
Phishing links

Logging System

Detailed logs for various events and activities on your Discord server.

Setup

Use /setup_logs to define your log channel.

Available Log Types

Message: Edits and deletes
Voice: Joins/Leaves/Mutes/Deafens
Member: Joins/Leaves and role updates
Invite: Create and Delete
Ban/Unban: All ban events
Channel: Create/Delete/Edit
Role: Create/Delete/Edit
Server: Name/Icon/Owner changes

Giveaway System

Host engaging giveaways with custom requirements, role restrictions, and prizes.

Configuration

Use /setup_giveaway to configure:

Question Channel: Setup channel
Giveaway Channel: Announcement channel
Authorized Role: Role allowed to create giveaways

Starting a Giveaway

Authorized users can start giveaways using /giveaway

Example /giveaway "Nitro Boosts" "3x Nitro Boosts" "3" "31/12/2024 23:59" "@Members" "http://example.com/image.png"

Leveling & Role System

Automatic XP management, levels, and role rewards. Users gain XP via participation.

Configuration Commands

Command Description
!enable_levels Enable leveling system
!disable_levels Disable leveling system
!set_xp 15 Set XP per message
!set_level_up_channel #channel Set level-up notification channel
!set_allowed_channels #general Limit XP gain to specific channels
!set_level_role 5 @Pro Assign role to level 5
!list_level_roles View all level-roles

Admin Commands

Command Description
!level @user Display XP & level
!increase_level @user 3 Increase user level
!decrease_level @user 2 Decrease user level
!reset_xp @user Reset user XP

Reaction Roles

Allow users to receive roles by reacting to emojis on specific messages.

Setup

Use /setup_reaction_role to configure:

Channel: Where the prompt is sent
Title: Embed title
Description: Embed description
Emoji-Role Pairs: e.g., 😊: @Member
Example /setup_reaction_role #roles "Select Roles" "React to get roles" "😊: @Member, 🎮: @Gamer"

Welcome & Leave Messages

Automated messages when members join or leave. Supports custom embeds with placeholders.

Welcome Setup

Use /setup_welcome with these options:

Channel: Destination channel
Title: Embed title
Description: Embed description (supports [user] and [server_name])
Image URL: Embed image
Color: Hex color (e.g., 0x3498db)
Example /setup_welcome #welcome "Welcome!" "Welcome, [user], to [server_name]!" https://example.com/image.png 0x3498db

Leave Messages

Use /set_leave_channel #channel to set the leave message channel.

Music System

High-quality music playback with queue management, skipping, and controls.

Setup

Use /setup_music to configure:

Voice Channel: Target voice channel
Text Channel: Control panel channel
Vote Count: Votes required to skip (1-10)
Roles: Controller roles (comma-separated)
Image URL: Embed image

Control Panel

Button Function
▶ Play Opens modal for YouTube URL/Name
🔀 Shuffle Randomize queue
⏹ Stop Clears queue
⏯ Pause/Unpause Toggle playback
🔁 Repeat Repeat current song
📜 Queue Show current queue
💾 Download Download as MP3 (320kbps)

Server Stats

Display real-time server statistics in voice channels. Updates every 6 minutes.

Commands

Command Description
/set_show_stats Enable/Disable stats system
/create_role_channel @role Create stats channel for specific roles
/delete_role_channel Delete a stats channel

Temporary Channels

Automatically creates voice channels when users join a "Waiting Room" and deletes them when empty.

Setup /configure_temp_channel [voice_channel] [category] "Temp -" [notify_role] [notify_channel]

Warning System

Issue warnings for rule violations. Logs are saved in database and persist across rejoins.

Commands

Command Description
/set_warn_channel #channel Set log channel
/warn [user] [role] [steam_id] [license] [reason] Issue warning
/remove_warning [user] [role] Remove warning
/check_warns [user] View active warnings

Shift Management

Full management of work shifts with automatic time tracking, breaks, and leaderboards.

Setup

Use /setup_shift to configure:

Work Channel: Shift start/stop text channel
Log Channel: Logs channel
On Duty Role: Active shift role
On Break Role: Break role

Control Panel

Reaction Action
🟢 Start Shift
🔴 End Shift
🔵 Take Break

Additional Commands

Command Description
/leaderboard View leaderboard
/add_time @User 2 30 0 Add time (2h 30m)
/force_end_shift @User Force end shift
/on_duty Show active users

AI Chatbot

Interact with an integrated AI Chatbot using slash commands.

Commands

Command Description
/ask Chat with AI
/setchannel Set authorized channel
/removechannel Remove authorized channel
Note

The /ask command has rate limits. The server must be whitelisted for this feature.

Twitch Notifications

Receive notifications when followed Twitch streamers go live.

Commands

Command Description
/set_notification_channel #channel Set notification channel
/add_streamer [username] Add a Twitch streamer
/remove_streamer [username] Remove a streamer
/list_streamers View registered streamers

Weather Monitoring

Real-time weather updates and air quality information.

Commands

Command Description
/weather [location] Get weather info
/setup_weather_channel #channel Set weather updates channel
Rate Limits

60 API calls per minute. 5 second cooldown per request per server.

URL Scanner

Check URL security using VirusTotal API. Detects malicious or suspicious URLs.

Usage /check_link https://example.com

Features

Scan URL with VirusTotal API
Detailed reports for scan results
Auto-detection of URLs in messages
Limits

Daily quota: 500 requests. Rate limit: 4 requests per minute.

Applications System

Create job application forms with multiple questions, role restrictions, and automatic role management.

Setup

Use /create_application to create a new application with:

Name, Description, Thumbnail/Image
Accepted/Denied/Confirmation messages
Restricted/Required/Accepted/Denied roles
Custom questions

Auto-Roles System

Automatically assign roles to new members when they join.

Commands

Command Description
/setautoroles @Role1 @Role2 @Role3 Set up to 3 auto-roles
/enableautorole Enable system
/disableautorole Disable system

Auto Reactions

Automatically add reactions to messages in specific channels.

Commands

Command Description
/set_react_channel #channel "⭐ 😂" Set channel with reactions
/remove_react_channel #channel Remove channel
/list_react_channels View all channels

Reviews System

Allow users to rate your server with 1-5 stars and optional comments.

Setup

Use /setup_review_embed to configure:

Channel: Where embed is sent
Title & Description: Embed content
Role: Role allowed to review
Color & Image: Embed styling

Server Graphs

View and analyze server statistics with visual graphs.

Usage

Use /server_stats with optional parameters:

Days: Number of days for stats (default: 7)
Categories: joins, leaves, bans, unbans (or "all")
Examples /server_stats days=14 categories=joins,leaves
/server_stats days=30 categories=all