Moderation Configuration¶
Configure and operate moderation using the current /mod, /cases, and /mod-debug command groups.
Current Command Groups¶
/mod- Core moderation actions (warn, timeout, kick, ban, purge, lockdown, role changes)/cases- Case lookup, reason updates, stats, notes, and export/import tools/mod-debug- Runtime checks and dry-run moderation diagnostics
Core Moderation Commands¶
| Command | Description |
|---|---|
/mod warn <member> <reason> |
Issue a warning |
/mod warnings <member> |
View active warnings |
/mod clearwarn <warning_id> |
Clear one warning |
/mod clearwarns <member> |
Clear all warnings for a member |
/mod timeout <member> <duration> [reason] |
Timeout in minutes (1 to 40320) |
/mod untimeout <member> [reason] |
Remove timeout |
/mod kick <member> [reason] |
Kick member |
/mod ban <user> [reason] [delete_days] |
Ban user and optionally delete 0-7 days of messages |
/mod softban <user> [reason] |
Ban + delete recent messages + immediate unban |
/mod tempban <member> <duration> [reason] [delete_days] |
Temporary ban with automatic expiry |
/mod unban <user_id> [reason] |
Remove ban |
/mod purge <count> [user] [contains] |
Bulk-delete messages with optional filters |
/mod lockdown [channel] [reason] |
Lock channel for @everyone |
/mod unlock [channel] |
Unlock channel |
/mod slowmode <seconds> [channel] |
Set slowmode (0-21600) |
/mod addrole <member> <role> [reason] |
Assign role |
/mod removerole <member> <role> [reason] |
Remove role |
Softban Notes¶
- Softban attempts an immediate unban right after the ban action.
- If unban fails, Armory Bot retries once using the raw user ID.
- If both attempts fail, moderators get an explicit warning with the target user ID for manual unban intervention.
Case Management Commands¶
| Command | Description |
|---|---|
/cases view <case_number> |
View one case |
/cases list <user> [limit] |
List recent cases for a user |
/cases reason <case_number> <new_reason> |
Update case reason |
/cases stats [moderator] |
Moderation statistics |
/cases duration <case_number> <duration> |
Update timed-case duration |
/cases history <user> |
Export user moderation history |
/cases import <file> |
Import moderation history JSON |
/cases note <user> <note> |
Add internal moderator note |
/cases notes <user> |
View notes |
/cases removenote <note_id> |
Remove one note |
/cases clearnotes <user> |
Clear all notes |
/cases report ... |
File a moderator report |
/cases snipe |
Show last deleted message in channel |
/cases massban ... |
Ban multiple user IDs |
AutoMod and Policy Settings¶
Armory Bot supports warning thresholds and automod behavior in runtime, but there is no /mod-config ... slash-command group in the current command surface.
Configure policy-level moderation settings through Dashboard/API configuration routes.
Use /mod-debug config to inspect currently loaded moderation configuration.
Logging Channel Guidance¶
Set your moderation log destination with the logging command group:
This routes moderation event embeds and related moderation logs into your chosen channel.
Permission Requirements¶
Moderators need one of:
- Manage Server permission
- Moderation command access (grant with
/permissions grant command_group:moderation ...)