xDefender Documentation
Advanced Security Bot for Discord Servers
Welcome to the xDefender documentation! xDefender is a powerful bot providing modular security protections against raids, spam, malicious links, and more. All interactions are handled via slash commands.
📈 Statistics
Protected Servers...
Protected Users...
Active Channels...
API Latency...
🛡️ Current Status
StatusOnline & Operational
Versionv3.6
StatusAccess Bot Customizable
StatusFree
Commands
All features are accessible via slash commands (e.g. /config, /help, /wh add).
General Commands
/help
Show the help menu with all available commands
/bot-info
Displays bot status, version, and uptime
/config
Modify all bot settings: protection modules, rate limits, logging, whitelist, and more
Whitelist & Blacklist Management
/wh
Manage whitelisted users. Only server owners can add via /wh add
/wh add
Add a user to the whitelist. Only available to server owners
/wh list
List all whitelisted users
/wh rm
Remove a user from the whitelist. Only available to server owners
/bl
Manage blacklist settings to block users
/bl add
Add a user to the blacklist to block them from using bot commands
/bl list
List all blacklisted users
/bl rm
Remove users from the blacklist && unban them
/bl sync
Synchronize the blacklist across servers or update blacklist data
Custom Bot Setup
Create your own xDefender instance with your Discord application
1️⃣ Create a Discord Application
Go to the Discord Developer Portal, click « New Application », give it a name, and create it. This application will become your bot.
2️⃣ Create the Bot & Enable Intents
In your application, go to « Bot » in the sidebar. Click « Add Bot ». Then enable the 3 Privileged Gateway Intents required for xDefender:
Presence Intent
Required for status roles and presence tracking
Server Members Intent
Required for member join/leave logs and anti-double account
Message Content Intent
Required for anti-spam, message logs and content moderation
⚠️ All 3 intents must be enabled. Without them, the bot will not work correctly.
3️⃣ Get Token & Client ID
In the « Bot » tab: copy your token (click « Reset Token » if needed, and keep it secret). In « General Information »: copy the Application ID (this is your clientid).
🔒 Never share your token. Anyone with it can control your bot.
4️⃣ Add Your Bot with /addbot
Join the xDefender support Discord, then use the slash command /addbot with your token and clientid. The bot will be registered and deployed for you.
/addbot
Add your custom bot. Parameters: token (your bot token), clientid (your application ID)
✓ Use the command in the dedicated channel on the xDefender Discord server.
5️⃣ Customize Your Bot
To modify your bot's profile picture, banner, name or other settings, use /config with the ManageBot bot on the xDefender Discord server.
System Information
Technical details about xDefender
⚙️ Technical Stack
Discord.js Versionv14.25.1
PlatformLinux
Bot Versionv3.6
📊 Server Statistics
Total Servers...
Total Users...
Active Channels...
Configuration
Complete configuration guide for all xDefender modules
🌍 Multi-Language Support
xDefender supports multiple languages for better accessibility and user experience.
The bot interface and responses are available in:
🇫🇷 Français
Interface complète en français avec toutes les commandes et messages traduits
🇬🇧 English
Full English interface with all commands and messages in English
🇪🇸 Español
Interfaz completa en español con todos los comandos y mensajes traducidos
🇩🇪 Deutsch
Vollständige deutsche Benutzeroberfläche mit allen Befehlen und Nachrichten übersetzt
✓ Language Selection: Use /config language to change the bot's language
🌐 Auto-Detection: The bot can automatically detect server language preferences
Anti-Spam Configuration
🚫 Anti-Spam Protections
xDefender's Anti-Spam system lets you configure advanced protections against spam, links, and unwanted invites.
You can also customize rate limits and allow spam in selected channels.
Spam Detection
Automatically detects and blocks users sending messages too fast. Ideal to prevent flood or raid attempts or MassPing or GhostPing.
Invite Link Blocker
Blocks Discord invite links across the server. Helps prevent users from promoting other servers.
Malicious Link Filter
Detects and removes suspicious or harmful URLs, including scam links and trackers.
Message Rate Limit
Customize how many messages a user can send per second. Useful to prevent spam while allowing active users to chat.
Whitelisted Channels
Exclude specific channels from anti-spam checks. Perfect for self-promotion, bot commands, or high-traffic areas.
Anti-Double Account
Detects and prevents users from joining with multiple accounts. Helps maintain server integrity and prevent abuse.
Anti-@everyone
Prevents abuse of @everyone and @here mentions. Protects your server from mass ping spam and notification abuse.
✓ Access Level: You have access to all protections in this category
🔒 Requirement: Requires whitelist/owner access
AutoMod Configuration
🤖 AutoMod Protections
Configure automated moderation for your server
🛡️ Invite Link Blocking
Blocks Discord invite links (e.g. discord.gg, discord.com/invite)
🔞 Dangerous/Adult Links Filtering
Blocks dangerous, adult or pornographic links
🤬 Bad Words Filter
Blocks messages containing bad words (customizable language)
👤 Anti-Double Account
Detects and prevents users from joining with multiple accounts from the same IP or device
+ AutoSetup will create all native Discord rules
Server Protection Configuration
🛡️ Server Protection
Configure server-level protections
antiChannelDelete
Prevents unauthorized channel deletions - Available to administrators
antiRoleDelete
Prevents unauthorized role deletions - Available to administrators
antiMassCreateChannel
Prevents mass creation of channels - Available to administrators
antiMassCreateRole
Prevents mass creation of roles - Available to administrators
antiServerEdit 🔒
Protects server settings from changes - Restricted to whitelist & owner
antiPermissions 🔒
Monitors dangerous permission changes - Restricted to whitelist & owner
🔧 Auto Channel Restore
Status: Enabled - Automatically recreates deleted channels with original permissions. Works when antiChannelDelete is enabled
🔧 Auto Role Restore
Status: Enabled - Automatically recreates deleted role with original permissions. Works when antiRoleDelete is enabled
Anti-Raid Configuration
🛡️ Anti-Raid Protections
Configure comprehensive raid protection
antiBot 🔒
Blocks unauthorized bots from joining - Restricted to whitelist & owner
antiMassban
Prevents mass banning of members - Available to administrators
antiWebhook
Protects against webhook abuse - Available to administrators
raidMode
Protects your server from mass account join spam — Admins only
antiApplicationExternal
Blocks external applications from accessing your server - Restricted to whitelist & owner
antiNewAccount
Prevents new accounts from joining (configurable age threshold) - Available to administrators
✓ Access Level: You have access to all protections in this category
🔒 Requirement: Requires whitelist/owner access
Backup System Configuration
📦 Backup System
Create, load, and manage complete server backups
➕ Create Backup
Create a complete backup of your server configuration including roles, channels, and permissions
📋 List Backups
View all available backups for your server
🌱 Load Backup
Restore your server from a previously created backup
❌ Delete Backup
Remove a backup from your server's backup list
⬇️ Import Backup
Import a backup file from another server
+ Backup Features:
• Backup all roles and their permissions
• Backup all channels and their permissions
• Backup all categories
• Import backups from other servers
Utils Configuration
🛠️ Utility Modules
Welcome, Alert Booster, and Status Role modules accessible via /config
Module de Welcome
Configure welcome messages sent when new members join your server
Module de Alert Booster
Configure alerts and notifications when members boost your server
Module de Status Role
Configure roles assigned based on member status (online, idle, do not disturb, etc.)
Logs Configuration
Setup comprehensive logging system for your server
📝 Log Channel Setup
Configure the log channel for all bot actions
Current Status
❌ No log channel configured - Current Log Channel: Not Set
⚠️ Important: Only the server owner can modify log settings
+ Choose a channel from the menu below
✅ Logging System Setup Complete
Example of successful log configuration
+ Log category created: xDefender Logs
+ 6 log channels configured
📂 Log Channels
🛡️ #mod-logs
Moderation actions and user punishments
💬 #message-logs
Message edits, deletions, and content monitoring
🏰 #server-logs
Server settings changes and administrative actions
👥 #member-logs
Member joins, leaves, and profile changes
📁 #channel-logs
Channel creation, deletion, and permission changes
🎭 #role-logs
Role creation, deletion, and assignment changes
📚 Next Steps:
All log channels have been created and configured. You can now return to the main menu.
Join Our Community
Connect with other server administrators and get support
