Introduction

Welcome to Defiant Bot! A powerful, all-in-one Discord bot designed to enhance your server with 13+ feature-rich systems.

What is Defiant Bot?

Defiant Bot is a comprehensive Discord bot that provides:

• 🎮 Leveling System - Reward active members with XP and roles
• 🛡️ Moderation Tools - Keep your server safe with warnings, mutes, and bans
• 📊 Logging System - Track all server events and actions
• 👥 Member Pop - Welcome messages and member analytics
• 🎵 Music - High-quality music playback
• 💬 Social - Social commands and engagement
• ⚡ Reaction Roles - Self-assignable roles via reactions
• 📺 Stream Alerts - Twitch, YouTube, and Kick notifications
• ⚔️ WoW Tracker - Mythic+ and Arena lookups
• 🎫 Ticket System - Support ticket management
• 🎤 Temp Voice - Temporary voice channels
• ✨ And More to Come! - Constantly adding new features and improvements

Quick Links

Installation

Get Defiant Bot up and running on your Discord server in just a few steps.

Step 1: Invite the Bot

Click the button below to invite Defiant Bot to your server:

Step 2: Initial Configuration

After inviting the bot, use the web dashboard or commands to configure your server:

Step 3: Enable Features

Choose which features you want to use:

• Leveling System - Reward active members
• Moderation - Keep your server safe
• Logging - Track server events
• Music - Play music in voice channels
• Stream Alerts - Monitor streamers

🎮 Leveling System

Reward your active members with XP, levels, and role rewards.

How It Works

Members earn XP by chatting in your server. As they gain XP, they level up and can unlock role rewards.

User Commands

Customization Commands

Admin Commands (Slash)

Help Commands

Dashboard Configuration

Configure leveling settings from the web dashboard:

• Enable/disable leveling system
• Set level-up announcement channel
• Configure ignored channels and roles
• Set up level role rewards
• Interactive admin panel with buttons

Features

• 🎨 Custom rank cards with banners & gradients
• 🏆 Server leaderboard competition
• 🎁 Automatic role rewards
• 📊 Visual progress tracking
• 🎛️ Interactive admin panel
• 📢 Dedicated level-up channel
• 🌈 Gradient color support

🛡️ Moderation Tools

Keep your server safe with powerful moderation commands and AutoMod.

Available Commands

AutoMod Features

• Spam Protection - Automatically mute users who spam
• Link Filtering - Block unauthorized links
• Word Filtering - Blacklist specific words
• Raid Protection - Prevent mass joins

📊 Logging System

Track all important events in your server with comprehensive logging.

Log Types

Message Logs

• Message edits
• Message deletions
• Bulk message deletions

Member Logs

• Member joins
• Member leaves
• Nickname changes
• Role changes

Moderation Logs

• Warnings issued
• Mutes and unmutes
• Bans and unbans
• Kicks

Server Logs

• Channel creation/deletion
• Role creation/deletion
• Server settings changes

Admin Commands

Ignore System

Help Commands

👥 Member Pop

Real-time member count tracking with locked voice channels.

What It Does

Creates a 📊 SERVER STATS 📊 category with locked voice channels that display:

• 👥 Members: X - Total non-bot members
• 🟢 Online: X - Currently online/idle/dnd members

These channels update automatically every 5 minutes!

Admin Commands

Help Commands

Features

• 🔒 Locked channels (display-only)
• 🔄 Auto-update every 5 minutes
• 📊 Real-time stats
• 🤖 Bot filtering (only counts humans)
• ⚡ One-command setup
• 📁 Organized in neat category
• 💾 Persists across bot restarts

🎵 Music

Play high-quality music in your voice channels with interactive controls and queue management.

Admin Setup Commands

Playback Commands

Queue Management

Autoplay & Playlists

Audio Control

Interactive Button Controls

Use the music control panel with buttons for easy control:

• ▶️ Play - Enter song or URL via modal
• ⏸️ Pause/Resume - Toggle playback
• ⏮️ Previous - Play previous song
• ⏭️ Next - Skip to next song
• 🔄 Restart - Restart current song
• ⏹️ Stop - Stop and clear queue
• 📋 Queue - View current queue
• 🔀 Shuffle - Shuffle queue
• 🔊 Volume - Adjust volume via modal
• 👋 Disconnect - Leave voice channel

Help Commands

Supported Sources

• 🔴 YouTube - Videos and playlists
• 🟢 Spotify - Songs and playlists
• 🟣 SoundCloud - Tracks
• 🔵 Bandcamp - Albums and tracks
• 📻 Direct links - Direct audio URLs

Features

• 🎮 Interactive button controls
• 📋 Queue management and visualization
• 🔀 Queue shuffling
• 💾 Queue persistence across restarts
• 🎵 **Autoplay** - Keeps playing similar songs when queue ends
• 💾 **Named Playlists** - Save and load your favorite song collections
• 🎨 Clean, modern embeds
• 🗑️ Auto-cleaning text channels
• 🔊 Volume controls with limits
• ⏯️ Playback controls

💬 Social Features

Engage your community with welcome messages, goodbye messages, autoroles, and custom prefixes.

Custom Prefix

Change the bot's command prefix from ! to whatever you want!

Welcome Messages

Goodbye Messages

Autoroles

Help Commands

Message Placeholders

Use these in your welcome/goodbye messages:

• {user} or {member} - Mentions the user
• {username} or {name} - User's username
• {server} - Server name
• {membercount} - Total member count

Features

• 🎉 Customizable welcome messages with embeds
• 👋 Customizable goodbye messages with embeds
• ⚙️ Automatic role assignment for new members
• 🎨 Custom embed colors
• 🔧 Flexible prefix system
• 📝 Dynamic placeholders
• 🤖 Optional bot filtering for autoroles
• 💾 Persists across bot restarts

⚡ Reaction Roles

Let members assign themselves roles by reacting to messages.

Setup Commands

Customization Commands

System Management

Help Commands

How It Works

1. Use !createrolesmessage to set up an embed
2. Add emoji/role pairs with !setreactionrole
3. Members react with emojis to get roles
4. Remove reaction to remove role

📺 Stream Announcements

Get notified when your favorite streamers go live on Twitch, YouTube, or Kick.

Setup

Supported Platforms

• 🟣 Twitch - Fully supported with instant webhook notifications
• 🔴 YouTube - Fully supported with instant webhook notifications
• 🟢 Kick - Supported with 10-minute polling

Customization

From the dashboard, you can customize:

• Announcement message format
• Ping role (optional)
• Embed color and styling
• Include/exclude game information

🎮 Twitch Integration - Full Channel Control

Link your Twitch account to manage your stream, analytics, and auto-roles directly from Discord.

Setup

1. Navigate to your server's dashboard → Twitch tab
2. Click "Link Twitch Account"
3. Authorize the bot with your Twitch account
4. Access all features from the dashboard

Features

📺 Stream Control

• Update Stream Title - Change your stream title without leaving Discord
• Change Game/Category - Search and select from thousands of games
• Live Status - Real-time viewer count and stream information
• Stream Tags - Add/remove tags to help viewers find your content

💬 Chat Settings

• Slow Mode - Control message frequency (configurable wait time)
• Subscriber-Only Mode - Restrict chat to subscribers
• Follower Mode - Require following before chatting (customizable duration)
• Emote-Only Mode - Allow only emotes in chat
• Unique Chat Mode - Prevent repeated messages

📊 Analytics & Insights

• View Count - Total channel views
• Follower Count - Current follower count
• Subscriber Count - Active subscriber count (if available)
• Recent Clips - View and share your latest clips
• Stream History - Track past broadcasts and performance

🎭 Auto-Roles

Automatically assign Discord roles based on Twitch status:

• Streamer Role - Assigned when you go live
• Subscriber Roles - Different roles for Tier 1, Tier 2, and Tier 3 subs
• VIP Role - Sync Twitch VIPs with Discord role
• Moderator Role - Sync Twitch mods with Discord role

⚡ Quick Actions

• Create Clip - Instantly create a clip of your live stream
• Run Commercial - Start a commercial break (30s, 60s, 90s, 120s, 150s, 180s)
• Start Raid - Raid another channel directly from Discord

💬 Live Chat Integration

• View Chat - Read Twitch chat in real-time
• Moderate Chat - Delete messages, timeout, or ban users
• Send Messages - Chat as your Twitch account from Discord

📊 Polls & Predictions

• Create Polls - Start channel polls with multiple choices
• Manage Predictions - Create and resolve predictions with Channel Points
• View Results - See real-time poll/prediction results

Permissions Required

The integration requests specific Twitch permissions based on features you use:

• channel:manage:broadcast - Update stream title, category, tags
• channel:read:subscriptions - View subscriber count
• moderation:read - View chat moderators
• channel:manage:moderators - Manage chat settings
• clips:edit - Create clips
• channel:manage:polls - Create and manage polls
• channel:manage:predictions - Create and manage predictions
• channel:manage:raids - Start raids

Security & Privacy

• ✅ OAuth 2.0 secure authentication
• ✅ Tokens stored encrypted in MongoDB
• ✅ Auto token refresh - stay connected indefinitely
• ✅ Disconnect anytime from dashboard
• ✅ We only request permissions for features you actually use

📺 YouTube Integration - Full Channel Control

Link your YouTube channel to manage streams, videos, analytics, and live chat directly from Discord.

Setup

1. Navigate to your server's dashboard → YouTube tab
2. Click "Link YouTube Channel"
3. Authorize with your Google account
4. Access all features from the dashboard

Features

📺 Stream Control

• Update Stream Title - Change your live stream title
• Edit Description - Update stream description
• Set Category - Choose from YouTube's video categories
• Live Status - Real-time viewer count and stream info
• Scheduled Streams - View and manage upcoming broadcasts

💬 Live Chat Management

• View Live Chat - Read YouTube live chat in real-time
• Send Messages - Chat as your YouTube channel
• Delete Messages - Remove inappropriate chat messages
• Ban Users - Permanently ban users from your chat
• Moderate Chat - Full moderation controls from Discord

📊 Channel Analytics

• Subscriber Count - Current subscriber count
• Total Views - Lifetime channel views
• Video Count - Total uploaded videos
• Recent Performance - Views, likes, and engagement metrics
• Top Videos - See your most popular content

🎬 Video Management

• View Recent Videos - Browse your latest uploads
• Update Video Details - Edit title, description, tags
• Change Thumbnails - Update video thumbnails
• Video Statistics - View counts, likes, comments per video

⚙️ Settings & Preferences

• Channel Branding - Update channel banner and logo
• Privacy Settings - Manage video visibility
• Category Selection - Browse and set video categories

Auto-Integration Features

• ✅ Auto-Add to Stream Monitoring - When you link your YouTube channel, it's automatically added to your server's monitored streamers list
• ✅ Discord Announcements - Bot will announce when you go live (updates every 10 minutes)
• ✅ Live Embed Updates - Stream title and viewer count refresh automatically in Discord

Permissions Required

YouTube integration uses Google OAuth with these scopes:

• youtube.readonly - View channel info and analytics
• youtube - Manage channel and videos
• youtube.force-ssl - Manage live streams
• youtube.channel-memberships.creator - View memberships

Security & Privacy

• ✅ Google OAuth 2.0 secure authentication
• ✅ Tokens stored encrypted in MongoDB
• ✅ Auto token refresh - stay connected
• ✅ Disconnect anytime from dashboard
• ✅ Compliant with Google API Services User Data Policy

Common Use Cases

⚔️ World of Warcraft Character Tracker

Check Mythic+ ratings and Arena rankings for any WoW character using Raider.IO and Blizzard API.

Mythic+ Commands

Arena/PvP Commands

Universal Character Lookup

Help Commands

Ratings Displayed

• Mythic+ Rating - Overall score and per-dungeon scores
• Best Runs - Top 5 Mythic+ dungeons with keystone levels
• 2v2 Arena - Current and highest rating
• 3v3 Arena - Current and highest rating
• RBG - Rated Battlegrounds rating
• Solo Shuffle - Solo queue rating
• Blitz - Battleground Blitz rating

Supported Regions

• us - North America (default)
• eu - Europe
• kr - Korea
• tw - Taiwan

Features

• 🔍 Real-time Raider.IO Mythic+ data
• ⚔️ Official Blizzard Arena/PvP ratings
• 💾 Save characters for quick lookups
• 📊 Detailed dungeon-by-dungeon breakdown
• 🏆 All PvP bracket ratings in one view
• 📝 Lookup history tracking
• 🌍 Multi-region support
• ⚡ Hybrid commands (prefix and slash)

🎮 Game Trackers

Track player stats across multiple games including Valorant, Fortnite, CS:GO, and Apex Legends.

Valorant Stats

View comprehensive Valorant player statistics using the Riot API and Henrik Dev API.

Features

• Account Stats - Current rank, RR (Ranked Rating), peak rank
• Performance Metrics - K/D ratio, headshot percentage, average combat score
• Match History - Recent matches with detailed stats
• Agent Stats - Performance breakdown by agent
• Competitive Data - Win rate, match count, rank progression

Supported Regions

• na - North America
• eu - Europe
• ap - Asia Pacific

Fortnite Stats

Track Fortnite Battle Royale statistics across all platforms.

Platforms

• pc - PC (Epic Games)
• psn - PlayStation Network
• xbl - Xbox Live

Time Windows

• season - Current season stats (default)
• lifetime - All-time career stats

Stats Displayed

• General Stats - Kills, wins, matches played
• K/D Ratio - Kill/Death performance
• Playtime - Total hours played
• Win Rate - Percentage of matches won

CS:GO Stats

View Counter-Strike: Global Offensive player statistics from Tracker.gg.

Stats Displayed

• Current Rank - Competitive matchmaking rank
• Highest Rating - Peak competitive rating
• Damage/Round - Average damage per round with percentile
• K/D Ratio - Kill/Death ratio
• Headshot % - Headshot accuracy percentage
• Win Rate - Percentage of matches won
• First Kills/Deaths - Opening duel statistics
• Multikills - Multi-frag performance
• Flash Assists - Utility usage effectiveness

Apex Legends Stats

Track Apex Legends player statistics from Tracker.gg.

Platforms

• origin - PC (Origin/EA App)
• psn - PlayStation Network
• xbl - Xbox Live

Lifetime Stats

• Matches Played - Total games
• Level - Account level
• Kills - Total eliminations
• Damage - Total damage dealt
• Wins - Total victories
• Winning Kills - Final eliminations in won games
• Kills as Kill Leader - Eliminations while leading
• Headshots - Headshot eliminations
• Finishers - Execution kills
• Revives - Teammate revivals
• Full Squad Wins - Wins with full team alive
• Weapon Stats - SMG, LMG, Care Package kills

🎫 Ticket System

Manage support tickets with button-based controls and dashboard configuration.

Dashboard Setup

Configure the ticket system via the web dashboard:

• Enable the ticket system
• Set ticket categories and naming
• Configure support roles
• Customize ticket panels

System automatically creates:

• #ticket-admin - Admin control panel with buttons
• #ticket-support - User ticket creation channel

User Commands

Admin Panel Features

All admin functions available via buttons in #ticket-admin:

• Add Role - Add ticket management role
• Remove Role - Remove ticket role
• List Roles - View all ticket roles
• View Stats - See ticket statistics
• Toggle Claim Mode - Enable/disable claim mode
• Reset System - Delete all tickets (owner only)

Ticket Channel Features

In each ticket channel, buttons are available for:

• Close Ticket - Close and archive the ticket
• Add Member - Add users to the ticket
• Claim Ticket - Claim ticket (if claim mode enabled)

Help Commands

Features

• 🎟️ Automatic ticket numbering
• 📝 Ticket transcripts saved on close
• 🔔 Support role notifications
• 📊 Ticket history and analytics
• 🎛️ Button-based controls
• ✋ Optional claim mode
• 🌐 Dashboard configuration

🎤 Temporary Voice Channels

Allow members to create their own temporary voice channels with full control via interactive buttons.

Dashboard Setup

Configure temp voice via the web dashboard:

• Enable the temp voice system
• Set channel names and categories
• Configure default permissions

System automatically creates:

• Join to Create voice channel - Trigger channel
• Users Channels category - For text control channels
• Temp Voice Channels category - For temporary VCs

How It Works

1. User joins the "Join to Create" voice channel
2. Bot creates a new temporary VC and text channel
3. User is moved to their new VC automatically
4. Text channel appears with interactive button controls
5. When VC is empty, both channels auto-delete

Control Panel Features

All controls available via buttons in the text channel:

• 👤 Kick User - Remove someone from your VC
• 🔒 Restrict Mode - Toggle whitelist-only access
• 👥 User Limit - Set maximum users (0-99)
• ✏️ Rename - Change your channel's name
• 📝 Whitelist - Add/remove users for restricted mode
• 🔄 Transfer - Give ownership to another user

Help Commands

Features

• 🎛️ Interactive button controls
• 🔒 Whitelist-only mode
• 👤 Full owner permissions
• 🔄 Automatic ownership transfer
• 📝 Customizable channel names
• 👥 User limit controls
• 🗑️ Auto-delete when empty
• 💾 Persists across bot restarts

Frequently Asked Questions

General Questions

Is Defiant Bot free?

Yes! Defiant Bot is completely free to use with all features available.

How do I change the bot's prefix?

Yes! You can set a custom prefix using the !prefix [new prefix] command. See the Social section for full details on custom prefixes.

Does the bot work in DMs?

Some commands work in DMs (like help and info commands), but most features require the bot to be in a server.

How do I get support?

Join our support server for help from our team and community.

Feature-Specific Questions

How does the leveling system work?

Members earn XP by sending messages (not spamming). The amount of XP can be configured, and you can set role rewards for specific levels.

Can I disable specific features?

Yes! You can enable/disable any feature from the web dashboard or using commands.

How often do stream alerts check for live streams?

Twitch and YouTube use instant webhooks. Kick is checked every 10 minutes due to API limitations.

Can I customize the appearance of embeds?

Many embeds can be customized from the dashboard, including colors and content. More customization options are being added!

Technical Questions

What permissions does the bot need?

The bot needs Administrator permissions for full functionality. You can grant specific permissions if you prefer, but some features may not work.

Where is my data stored?

All data is stored in a secure MongoDB database with regular backups. We never share your data with third parties.

Troubleshooting

Solutions to common issues with Defiant Bot.

Bot Not Responding

Check Bot Status

• Verify the bot is online (green status in member list)
• Check if the bot has been kicked or banned
• Ensure the bot role has necessary permissions

Command Issues

• Verify you're using the correct prefix (!)
• Check that the bot can read messages in that channel
• Ensure you have the required permissions to use the command

Leveling System Issues

XP Not Being Awarded

• Check if leveling is enabled in dashboard
• Verify the channel isn't in the XP blacklist
• XP has a cooldown to prevent spam (60 seconds)

Role Rewards Not Working

• Ensure the bot's role is higher than the reward role
• Check that "Manage Roles" permission is enabled
• Verify the role reward is correctly configured

Music Issues

Bot Won't Join Voice Channel

• Ensure bot has "Connect" and "Speak" permissions
• Check if the channel has a user limit that's full
• Verify you're in a voice channel when using play command

Music Sounds Distorted

• Try lowering the volume with !volume 50
• Check your server's region settings
• The bot may be under heavy load - try again later

Stream Alerts Issues

Notifications Not Posting

• Verify announcement channel is set with !setstreamchannel
• Check bot has "Send Messages" and "Embed Links" permissions
• Ensure streamer username is spelled correctly
• For Kick streams, allow up to 10 minutes for detection

Permission Errors

Still Having Issues?

If you're still experiencing problems:

1. Join our support server for live help
2. Check our GitHub issues for known bugs
3. Use the !debug command to get diagnostic information
4. Report bugs on GitHub with detailed steps to reproduce