Moderation Bot

Clean, configurable moderation for your Discord server. Every action is role-controlled, logged, and DM-notified — all set up directly in Discord with no dashboard required.

---

Features

• Core Moderation Commands — Ban, unban, kick, timeout, untimeout, warn, and nickname management
• Flexible Permission System — Assign specific roles to each moderation action (no need to give full Admin)
• Immune Roles — Protect certain roles from being targeted by mod actions
• Moderation Logs — Every action is recorded with moderator, action type, target, and reason
• DM Notifications — Targets are automatically notified when action is taken against them
• Appeal Links — Include a custom appeal link in ban DMs
• Cooldowns — Set cooldowns per action type to prevent abuse
• Role Hierarchy Checks — Automatically prevents moderating members with higher roles

---

Commands

Moderation:

| Command | Description |
|---------|-------------|
| /ban <user> <reason> | Ban a user (works on non-members too) |
| /unban <user> <reason> | Unban a user |
| /kick <member> <reason> | Kick a member |
| /timeout <member> <duration> <reason> | Timeout a member (e.g. 1d 6h 30m, max 28 days) |
| /untimeout <member> <reason> | Remove a member's timeout |
| /warn <member> <reason> | Warn a member |
| /nickname <member> <reason> [nickname] | Change or reset a member's nickname |

Logs:

| Command | Description |
|---------|-------------|
| /modlogs <user> | View the latest 20 moderation actions for a user |
| /raw-modlogs <user> | Export all logs as a downloadable text file |

Configuration (Admin only):

| Command | Description |
|---------|-------------|
| /config | Open the configuration panel — manage allowed roles, immune roles, cooldowns, and appeal links per action type |
| /help | View all available commands |

---

Quick Setup

1. Invite the bot with the required permissions
2. Run /config to assign allowed and immune roles for each action type
3. Optionally set a ban appeal link to include in DMs
4. Your moderators can now use commands based on their configured roles

---

Support

Join our Support Server for help and feature requests.