# ModGuardBot An advanced Discord moderation and security bot that automatically protects servers from spam, raids, and malicious behavior. ## Features ### Auto Moderation - **Spam Detection**: Automatically detects and times out users sending messages too quickly - **Profanity Filter**: Customizable word filter with automatic warnings and timeouts - **Caps Spam Protection**: Removes messages with excessive capital letters - **Mention Spam Protection**: Prevents mass mention abuse - **Link Protection**: Whitelist-based URL filtering ### Security Features - **Anti-Raid Protection**: Detects and responds to raid attempts - **Account Age Check**: Automatically kicks new accounts - **Suspicious Username Detection**: Filters usernames with suspicious patterns - **Lockdown Mode**: Temporarily prevent new members from joining - **Join/Leave Logging**: Track all member activity ### Moderation Commands - `!warn [reason]` - Warn a member - `!kick [reason]` - Kick a member - `!ban [reason]` - Ban a member - `!unban [reason]` - Unban a user - `!timeout [reason]` - Timeout a member - `!clear ` - Delete messages (1-100) ### Security Commands - `!lockdown ` - Enable/disable lockdown mode - `!massban ` - Ban multiple users at once - `!nuke` - Delete and recreate a channel - `!setlog ` - Set the log channel for moderation actions ## Setup 1. Install Python 3.8 or higher 2. Install dependencies: ```bash pip install -r requirements.txt ``` 3. Create a Discord bot at https://discord.com/developers/applications 4. Edit `.env` file and add your bot token: ``` DISCORD_TOKEN=your_bot_token_here ``` 5. Configure `config.json`: - Set your desired command prefix - Configure moderation rules - Add profanity words to filter - Set up whitelisted domains for link protection - Add mod role IDs and exempt role IDs 6. Run the bot: ```bash python bot.py ``` 7. Set a log channel in your server: ``` !setlog #mod-logs ``` ## Configuration Edit `config.json` to customize: - **Spam Detection**: Adjust message threshold and time window - **Profanity Filter**: Add words to filter list - **Anti-Raid**: Configure join threshold and actions - **Account Age Check**: Set minimum account age in days - **Exempt Roles**: Add role IDs that bypass auto-moderation - **Mod Roles**: Add role IDs that can use moderation commands ## Required Permissions The bot needs these permissions: - Manage Messages - Kick Members - Ban Members - Moderate Members (for timeout) - Manage Channels (for nuke command) - Read Message History - Send Messages - Embed Links ## Support For issues or questions, please open an issue on GitHub.