moderation
Moderation
Warnings, timeouts, kicks, bans, cases, and the moderator hierarchy — the platform's core moderation toolkit.
Enabled by defaultNo privileged intents required
Warnings, timeouts, kicks and bans — with a case number for every one of them.
Why gaming communities love it
- Competitive lobbies and voice channels get heated; a moderator hierarchy stops a helper from ever touching an admin, the owner, or the bot itself.
- Escalation rules (three warnings triggers a timeout, say) keep enforcement consistent across a large staff roster instead of depending on who is online.
- Every action gets an immutable case number, a reason, and an optional evidence link — useful when a banned player disputes it in a support ticket.
- Temporary punishments expire on their own with a background job, so nobody has to remember to `/unban` someone at 3am.
Full command reference
| Command | Description | Who can use it | Example |
|---|---|---|---|
/mod warn | Warn a member. Repeated warnings can trigger automatic escalation. | Helper+ | /mod warn user:@user [reason:"spamming links"] [evidence:"evidence"] |
/mod warnings | List a member's warnings, or every active warning if no member is given. | Helper+ | /mod warnings [user:@user] |
/mod clearwarns | Clear a member's active warnings. | Helper+ | /mod clearwarns user:@user [id:"id"] |
/mod timeout | Time out a member (up to 28 days). | Helper+ | /mod timeout user:@user duration:1h [reason:"spamming links"] |
/mod untimeout | Remove a member's timeout. | Helper+ | /mod untimeout user:@user [reason:"spamming links"] |
/mod kick | Kick a member from the server. | Helper+ | /mod kick user:@user [reason:"spamming links"] [evidence:"evidence"] |
/mod ban | Ban a user from the server. | Helper+ | /mod ban user:@user [reason:"spamming links"] [delete-days:10] [duration:1h] [evidence:"evidence"] |
/mod unban | Unban a user by id. | Helper+ | /mod unban user-id:@user [reason:"spamming links"] |
/mod softban | Ban and immediately unban a user — clears their recent messages without a lasting ban. | Helper+ | /mod softban user:@user [reason:"spamming links"] [delete-days:10] [evidence:"evidence"] |
/mod purge | Bulk-delete recent messages in this channel. | Helper+ | /mod purge count:10 [user:@user] [contains:"contains"] [reason:"spamming links"] |
/mod lock | Lock a channel (prevent @everyone from sending messages). | Helper+ | /mod lock [channel:#general] [reason:"spamming links"] |
/mod unlock | Unlock a previously locked channel. | Helper+ | /mod unlock [channel:#general] [reason:"spamming links"] |
/mod slowmode | Set (or turn off) a channel slowmode. | Helper+ | /mod slowmode seconds:"seconds" [channel:#general] |
/mod nick | Change a member's nickname. | Helper+ | /mod nick user:@user nickname:"nickname" |
/mod note | Add a staff note about a member (visible to staff only). | Helper+ | /mod note user:@user text:"text" |
/mod case | Show a moderation case by number. | Helper+ | /mod case number:10 |
/mod cases | List moderation cases, optionally filtered. | Helper+ | /mod cases [user:@user] [type:"type"] |
/mod appeal-setup | Set the staff channel where appeals are posted (admin). | Helper+ | /mod appeal-setup channel:#general |
/mod role add | Add a role to a member. | Helper+ | /mod role add user:@user role:@Moderators [reason:"spamming links"] |
/mod role remove | Remove a role from a member. | Helper+ | /mod role remove user:@user role:@Moderators [reason:"spamming links"] |
/appeal | Appeal a moderation case taken against you. | Everyone | /appeal case-number:10 |
/Warn userUser context menu | Moderator+ | /Warn user | |
/View casesUser context menu | Helper+ | /View cases |