Moderation commands
Ban, kick, timeout, mute, warn and clear — with reasons, DMs and a log.
Before you start
- A moderation log channel (Logging) so every action is recorded.
#Safety rules every command follows
- You can’t act on the server owner, Apera, yourself, or anyone whose top role is equal to or above yours.
- Apera DMs the member the reason before acting (when their DMs are open).
- The reason is written to the audit log as “reason — by you”, so logs always show who did it.
- Missing a required option? Apera replies with how to use the command instead of an error.
#Which permission each command needs
| Command | Needs | Also as |
|---|---|---|
/ban, /unban | Ban Members | !ban, !unban |
/kick | Kick Members | !kick |
/timeout, /untimeout, /mute, /unmute, /warn | Moderate Members | !timeout, !mute, !warn… |
/clear | Manage Messages | !clear |
/unbanall, /jail, /audit | Administrator | !jail |
#Timeout, mute or jail?
- Timeout — ends by itself (up to 28 days). Best for most cases.
- Mute — the Muted role, no end time, until
/unmute. - Jail — takes all roles away and hides every channel; roles come back after.
#What members receive
Before a ban, kick, timeout, mute or warning, Apera tells the member in DM which server, why, and (for timeouts) until when.
#Cleaning up messages
/clear without a number explains itself; with filters it removes only one member’s messages, only bots, or only messages containing some text.
Commands in this guide
/banBan a member, or anyone by user ID — even people who already left./unbanUnban a user by their ID./kickKick a member from the server./timeoutTimeout a member for a while — they can’t chat, react or talk./untimeoutEnd a member’s timeout early./muteMute a member with the Muted role until you unmute them./unmuteUnmute a member./warnGive a member a warning./warningsSee, delete or clear a member’s warnings./clearDelete recent messages in this channel./unbanallUnban every banned user at once.Next steps
Was this page helpful?
Thanks for telling us!