Features Commands Guides Forum Changelog Roadmap FAQ Compare Store
Online

Feature

Discord moderation bot

Every warn, timeout, kick and ban is recorded as a case you can look up, edit and export. Staff notes stay private. Banned members can appeal from their DMs instead of hunting for an alt account.

Setup guide
23commands
Freeno vote-lock
3guides

Cases, not just actions

Each moderation action is stored with its reason and moderator. /mod cases view shows someone's history; /mod cases export saves it as a text file for appeals or handovers.

Private staff notes

Leave context that never reaches the member: "warned verbally in VC", "alt of X". Notes can be exported too.

Ban appeals

Bans can include an appeal link. Appeals arrive in the channel you set with /mod appeal-channel, so you review them in one place.

Precise purges

/mod purge filters by user, role, message type or text, so you can clean up a spam wave without wiping the conversation around it.

Server logs

/logging setup records edits and deletes, joins and leaves, voice moves, and role and channel changes.

Proof attached

Warns, timeouts and bans accept a proof attachment, kept with the case.

Set it up

  1. Run /mod log-channel and pick a staff-only channel. Every action Hana takes is posted there.
  2. Run /mod appeal-channel if you want to accept ban appeals.
  3. Run /logging setup, then /logging config to choose which events to record.
  4. Drag Hana's role above the roles she needs to moderate (Server Settings → Roles). A bot cannot act on anyone whose top role is higher than its own.

Related guides

Questions

Can moderators without admin use these commands?

Yes. Each command checks the matching Discord permission (for example Ban Members for bans), so moderators only get what their role already allows.

Can a ban be temporary?

Yes. /mod ban add takes an optional duration and Hana lifts the ban when it runs out.

Commands

Staff commands are marked with the permission they need. Full reference.

Moderation

/mod settings Staff

Server moderation setup.

/mod appeal-channel Manage Server

Set the exclusive channel for Tribunal Appeals.

  • channeloptional Target channel (leave blank to clear).
/mod log-channel Manage Server

Set the exclusive channel for Moderation action logs.

  • channeloptional Target channel (leave blank to clear).
/mod clone-perms Manage Server

Clone channel perms. SERVER MANAGERS ONLY.

  • source The channel to copy permissions FROM.
  • target The channel to OVERWRITE permissions TO.
/mod lockdown Manage Channels

Instantly freeze or unfreeze a channel during a raid.

  • action Enable or Disable.
  • channeloptional Target channel.
  • reasonoptional Lockdown reason.
/mod slowmode Manage Channels

Set channel slowmode.

  • duration Duration (e.g., 5s, 10m, 1h). '0s' to disable.
  • channeloptional Specific channel (defaults to current).
/mod purge Manage Messages

Advanced chunked message sweep with real-time feedback.

  • amount Number of messages (1-1000).
  • useroptional Filter by member.
  • roleoptional Filter by role.
  • filter_typeoptional Filter by type (Bots, Embeds, Links, Attachments, Mentions).
  • containsoptional Filter by text.
/mod kick Kick Members

Kick a member from the server.

  • target The member to kick.
  • reasonoptional Reason for the kick.
  • dmoptional Whether to DM the user with the action detail.
/mod warn Moderate Members

Warn a member.

  • user The user to warn.
  • reason Reason for warn.
  • dmoptional Whether to DM the user with the warning details.
  • proofoptional Optional image proof.
/mod ban add Ban Members

Ban a user with an optional Tribunal Appeal link.

  • user User to ban.
  • reasonoptional Reason.
  • durationoptional E.g. 5d, 10m (empty for perm).
  • softoptional Instantly unban to wipe messages.
  • purge_daysoptional Days of messages to wipe (0-7).
  • dmoptional DM user.
  • appealableoptional Provide the user an option to appeal their ban.
  • proofoptional Proof attachment.
/mod ban remove Ban Members

Unban a user.

  • user The user to unban.
  • reasonoptional Reason for the unban.
  • dmoptional Whether to DM the user notifying them they have been unbanned.
/mod timeout add Moderate Members

Timeout a member.

  • user User.
  • duration E.g. 10m, 1h, 1d.
  • reasonoptional Reason.
  • dmoptional DM user.
  • proofoptional Proof attachment.
/mod timeout remove Moderate Members

Remove timeout from a member.

  • user The member to lift timeout from.
  • reasonoptional Reason for untimeout.
  • dmoptional Whether to DM the user notifying them their timeout has been lifted.
/mod notes add Moderate Members

Add a note to a user.

  • user The user to append a note to.
  • message The internal note contents.
  • dmoptional Whether to notify the user via DM regarding the added note.
/mod notes remove Moderate Members

Remove a note using its ID.

  • user The user whose note you want to remove.
  • note_id The unique ID of the note to scrub.
  • dmoptional Whether to notify the user via DM regarding the note removal.
/mod notes view Moderate Members

View notes for a user.

  • user Target user.
/mod notes export Moderate Members

Export a user's entire note log as a formatted text file.

  • user Target user.
/mod cases view Moderate Members

View moderation cases for a user.

  • user Target user.
/mod cases remove Administrator

Remove a moderation case.

  • case_id The ID of the case to remove.
  • dmoptional Whether to DM the user notifying them of the case removal.
/mod cases edit Moderate Members

Edit the reason for a specific case.

  • case_id The ID of the case to modify.
  • new_reason The modified reason for this case ID.
  • dmoptional Whether to DM the user notifying them of the change.
/mod cases export Moderate Members

Export a user's entire case history as a formatted text file.

  • user Target user.

Server logs

/logging setup Staff

Pick the log channel and start logging.

/logging config Staff

Choose which events are logged.

Try it on your server.

Free, set up in a few minutes, and easy to remove if it isn't for you.

Getting started