Skip to content

Moderation System

Armory Bot moderation combines direct actions, warnings, case tracking, and incident tooling. Integrates with built-in Audit Log.

Command Groups

  • /mod - Main moderation actions
  • /cases - Case/notes/history/report tools
  • /mod-debug - Diagnostics and dry-run checks

Core Actions

Member actions (/mod)

  • Kick, ban, softban, unban, tempban
  • Timeout and untimeout
  • Warn, warnings, clearwarn, clearwarns
  • Purge message batches with optional filters
  • Lockdown/unlock and slowmode
  • Add/remove roles with hierarchy checks

Case tracking (/cases)

  • View/list/update case reasons
  • Stats and moderation activity summaries
  • Massban helper for raids
  • History export/import
  • Internal moderator notes
  • Incident report command
  • Snipe last deleted message

Warning and Escalation Behavior

Warnings are persisted and surfaced through /mod warnings and case records.

Warning threshold actions and automod policy settings are configurable through both slash commands and Dashboard/API moderation routes.

Configuration Commands (/mod-config)

  • /mod-config setup
  • /mod-config logchannel <channel>
  • /mod-config automod <enabled> [spam] [links] [badwords]
  • /mod-config warnings <threshold> [action] [decay_days]
  • /mod-config limits [mention_limit] [caps_threshold]
  • /mod-config view

Typical Workflow

  1. Add a warning:
/mod warn member:@User reason:"Spam in #general"
  1. Escalate if behavior continues:
/mod timeout member:@User duration:60 reason:"Continued disruption"
  1. Inspect history:
/cases list user:@User limit:10
/cases view case_number:42
  1. Update case details when needed:
/cases reason case_number:42 new_reason:"Updated after appeal review"

Bulk and Channel Controls

Purge

/mod purge count:50
/mod purge count:25 user:@User
/mod purge count:20 contains:"discord.gg"

Lockdown and slowmode

/mod lockdown reason:"Raid mitigation"
/mod slowmode seconds:10
/mod unlock

Permissions

Moderation commands require:

  • Manage Server permission, or
  • Explicit moderation override using /permissions grant command_group:moderation ...

Role assignment commands (/mod addrole, /mod removerole) require the roles command category.

Logging and Audit

Moderation actions create case records and can be routed to a moderation log channel through logging configuration:

/logging setup mod_channel:#mod-logs

Use:

/mod-debug config

to inspect active moderation runtime configuration.

Troubleshooting

Action fails with permission error

  1. Confirm bot role is above target member role.
  2. Confirm bot has required Discord permission for the action.
  3. Confirm moderator has required command permission.

Warning escalation not matching policy

  1. Check policy values in Dashboard/API moderation settings.
  2. Verify /mod warnings output for the target user.
  3. Verify active config using /mod-debug config.

Purge removes fewer messages than expected

  1. Message filters (user, contains) may reduce matches.
  2. Discord bulk-delete constraints can limit removable messages.