Apera DocsBeta

Moderation commands

Ban, kick, timeout, mute, warn and clear — with reasons, DMs and a log.

Open in dashboard 5 sections
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

CommandNeedsAlso as
/ban, /unbanBan Members!ban, !unban
/kickKick Members!kick
/timeout, /untimeout, /mute, /unmute, /warnModerate Members!timeout, !mute, !warn…
/clearManage Messages!clear
/unbanall, /jail, /auditAdministrator!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

Next steps