Tutorials3 min read

Discord Moderation Bot: Ban, Kick, Mute, Warn — TeraOne 2026

Seven slash commands for Discord moderation with audit history, immune roles and hierarchy checks — no hidden escalation, clear safeguards.

Moderation: Keep your server clean

Good Discord moderation is boring — and that is exactly the goal. Seven slash commands, clear safeguards, a complete audit history. No hidden escalation magic, no black box.

What it does

  • 7 slash commands/ban, /unban, /kick, /mute, /unmute, /warn, /history. Each with clean options and an ephemeral confirmation for the moderator.
  • Duration presets for mute — Discord timeout with presets (60 s, 5 min, 10 min, 1 h, 1 d, 1 week, 28 d). No millisecond math.
  • Message cleanup on ban — optionally delete the user's last 0, 1 or 7 days of messages. Right in the /ban dialog.
  • Immune roles — up to 50 protected roles per server. Members with an immune role cannot be moderated — the command is rejected with a plain-text error.
  • Optional DM — toggle per command, plus a global default in the dashboard. Fails silently when DMs are blocked.
  • Full audit history/history <user> shows every action with reason, moderator, duration and timestamp. In the dashboard with cursor pagination and filters by action type.

How to set it up

  1. Open Dashboard → Moderation.
  2. Enable the module.
  3. Set immune roles — e.g. @Admin, @Senior Mod, @Bot Team. Up to 50 roles.
  4. Optional: set a global DM default ("user is notified by DM" on/off).
  5. In Discord, drag the TeraOne role above every role you want to moderate in the server role settings.
  6. Get going: /warn @user reason or /mute @user 1h reason.

More in the dashboard.

Tips for better results

  • Create a Protected immune role and assign it to user IDs that need account-level protection — immunity goes through roles, not user IDs.
  • Ban with 1-day cleanup is usually enough — 7 days also wipes long-past valuable posts.
  • Check /history regularly — repeated warns make escalation patterns visible at a glance.

FAQ

Do warns count toward Discord timeouts? No. /warn is a pure log entry — no automatic escalation to mute or ban. The entry shows up in /history and the dashboard, the user is optionally DMed.

What happens when I remove the bot? Server-specific data (ModAction, ModerationConfig) is auto-deleted 30 days after the bot leaves the server.

How does the bot hierarchy work? Discord only lets the bot moderate users whose highest role sits below the bot's highest role. Drag the TeraOne role up in your server role settings.


Need help? Join our Discord server.