Moderation Cases & Logging
The day-to-day moderation commands (ban, kick, timeout, warn, warn escalation) plus the case system, history and audit tools.
Every punishment your staff hand out is saved as a numbered case with the type, target, moderator, reason, time and any proof, so scattered bans become a searchable history. These commands work the moment exceed joins, with no setup, and each respects role hierarchy and the matching Discord permission.
Punishment commands
,ban @user reason ban a member (alias ,b)
,tempban @user 7d reason ban, then auto-unban after the time (alias ,tb)
,softban @user reason ban and instantly unban to wipe recent messages (alias ,sb)
,hardban @user reason keep them banned even if re-added (alias ,hb)
,hardban list show everyone on the hardban list (also ,hardbanlist)
,kick @user reason kick a member (alias ,k)
,timeout @user 10m reason time a member out (alias ,to)
,jail @user reason strip roles and confine to the jail role
,warn @user reason warn a member (alias ,w)
,stripstaff @user remove every dangerous-permission role (alias ,strip)
Durations look like 30m, 1h, 7d. Jail stores the member's roles so they can be restored later; set the jail role with ,setup.
Warnings and escalation
Warnings stack, and you can make them punish automatically once a member crosses a threshold.
,warn @user spamming add a warning (alias ,w)
,warns @user list active warnings (aliases ,warnings, ,warnlist)
,clearwarns @user clear all warnings (alias ,cw)
,warnescalation add 3 timeout 1h auto-punish at 3 warnings
,warnescalation add 3 timeout 10m --multiplier 2 harsher on every repeat
,warnescalation decay 30 expire warnings older than 30 days
,warnescalation list show thresholds and decay
Repeat offenders
--multiplier makes a punishment harsher each time the same member hits the same threshold again. With --multiplier 2 on a 10 minute timeout, their first offence is 10 minutes, the next is 20, then 40, and so on. Leave it off for a flat punishment every time.
The multiplier only applies to timed actions (timeout and mute) and is capped at Discord's 28 day timeout limit. It can also be set from the Warn Escalation page on the dashboard.
Reviewing cases
,caselog 42 show one case in full (alias ,case)
,history @user a member's full history (aliases ,modlogs, ,cases)
,reason 42 ban evasion update a case's reason
,notes @user view private mod notes (alias ,note)
,proof add 42 <url> attach proof to a case (alias ,evidence)
Staff insight and audit
,moderationhistory @mod cases a moderator has issued (alias ,modhistory)
,modstats moderator action stats / leaderboard (alias ,staffstats)
,audit @user recent Discord audit-log entries (alias ,al)
Example
Warn a spammer, check their record, and set escalation:
,warn @user mass pinging
,warns @user
,warnescalation add 3 timeout 1h
Tip: Set a mod log channel so every case is mirrored in one place. Broader event logging (joins, leaves, edits, deletes) lives in the dashboard's Logging section.
Related
- For automatic punishments driven by filters and spam, see Automod.
- To guard against a moderator abusing these commands, see Moderator Accountability.