Moderation Cog

See also: Quick Start Guide for initial setup, and Features Reference for a deep-dive into mute persistence, role persist, and modlog sharing.

The Moderation cog provides a comprehensive suite of moderation tools for managing your Discord server. It includes advanced case management, automated logging, and a wide range of moderation actions.

Features

Core Moderation

  • Ban, kick, mute, warn, and timeout users
  • Temporary or permanent actions with duration support
  • Softban and account compromise handling
  • Automatic timeout expiry management

Case Management

  • Automatic incrementing case numbers for tracking
  • View, edit, and update case information
  • Modify reasons and durations after the fact
  • Complete moderation action history per user

User Information

  • Detailed user lookup with account flags and status
  • Role information and server join dates
  • Account creation dates and profiles
  • Cross-server modlog tracking

Role Persistence

  • Automatically restore roles when users rejoin
  • Manage persistent role assignments per user
  • List and monitor role persist entries

Logging and Audit

  • Dedicated modlog channel for all actions
  • Rich embed formatting with user details
  • Complete audit trail of all changes
  • Global moderation tracking across actions

Analytics

  • Moderation statistics per user
  • Count actions within date ranges
  • Track moderator activity
  • Monitor mute status

Commands

Moderation Actions

| Command | Description | |———|————-| | /kick <user> [reason] | Kick a user from the server | | /ban <user> [duration] [reason] | Ban a user (permanent or temporary) | | /warn <user> <reason> | Issue a warning to a user | | /editwarn <case> <reason> | Edit the reason for a warning | | /mute <user> <duration> <reason> | Timeout a user for specified duration | | /unmute <user> | Remove mute/timeout from user | | /unban <user> | Unban a previously banned user | | /comped [user] | Softban and mute compromised account |

Case Management

| Command | Description | |———|————-| | /case <number> | View details of a specific case | | /reason <case> <reason> | Update the reason for a case | | /duration <case> <duration> | Update the duration for a case |

Information & Lookup

| Command | Description | |———|————-| | /whois <user> | Detailed user lookup (flags, roles, dates, etc.) | | /modlogs [user] | View moderation logs (global or for specific user) | | /modstats <user> | Show moderation statistics for user | | /modactions <start_date> <end_date> | Count mod actions within date range |

Role Persistence

| Command | Description | |———|————-| | /rolepersist apply | Apply role persist to a member | | /rolepersist remove | Remove role persist from member | | /rolepersist list | List all role persist entries |

Channel Management

| Command | Description | |———|————-| | /slowmode <seconds> [channel] | Set slowmode on a channel (0 to disable, max 21600s). Defaults to current channel. | | /lock [channel] [duration] [reason] | Lock a channel — removes @everyone send permission. Optionally auto-unlocks after a duration (e.g. 1h, 30m). | | /unlock [channel] [reason] | Unlock a previously locked channel. |

Utilities

| Command | Description | |———|————-| | /dm <user> [message] | Send a private message to a user | | /purge [count] | Purge messages from current channel | | /moderation list_muted_users | Show all currently muted users in the server | | /moderation check_muted_users | Audit muted users - clean up expired mutes and missing roles |

Administration

| Command | Description | |———|————-| | /moderation config | Open the interactive moderation configuration panel | | /moderation help | View all moderation commands with usage examples | | /moderation ban_appeal_message | Set the message appended to ban DMs (e.g. an appeal link) | | /moderation preset add <name> <reason> | Save a preset reason for autocomplete in moderation commands | | /moderation preset delete <name> | Remove a preset reason | | /moderation preset list | View all saved preset reasons | | /moderation share_modlogs_with <server_id> | Share this server’s modlogs with another server | | /moderation unshare_modlogs_with <server_id> | Remove a server from your modlog sharing list | | /moderation accept_modlogs_from <server_id> | Accept modlogs shared from another server | | /moderation stop_accepting_from <server_id> | Stop accepting modlogs from a server | | /moderation list_sharing | View current modlog sharing configuration |

Prefix Commands

| Command | Description | |———|————-| | !whois <user> | User lookup (prefix version) | | !mymodlogs | View your own modlogs | | !modlogs <user> | View user modlogs | | !warn <user> <reason> | Warn user (prefix version) | | !editwarn <case> <reason> | Edit warning reason | | !ban <user> [duration] [reason] | Ban user | | !mute <user> <duration> <reason> | Mute user | | !unmute <user> | Unmute user | | !unban <user> | Unban user | | !case <number> | View case | | !reason <case> <reason> | Update case reason | | !duration <case> <duration> | Update case duration | | !modstats <user> | View user moderation stats | | !comped <user> | Handle compromised account |

Configuration

Customize your moderation setup with these settings:

  • Enabled - Toggle the moderation system
  • Log Channel - Channel where all moderation actions are logged
  • Mod Roles - Roles that can use moderation commands
  • Kick Roles - Roles that can kick users
  • Ban Roles - Roles that can ban users
  • Timeout Roles - Roles that can timeout users
  • Warn Roles - Roles that can warn users
  • Modlogs Show Moderator Channels — Channels where the acting moderator’s name is included in modlog embeds. Moderator names are always hidden in shared (cross-server) modlogs regardless of this setting.

Integration

Works seamlessly with:

  • Notes System - Attach notes to moderation cases
  • Alt Tracker - Check for alternate accounts
  • Reputation System - Consider helper status in moderation
  • Vor Sentinel - Enhanced automod capabilities

Best Practices

  1. Use /whois before action to understand user context
  2. Always provide detailed and specific reasons for actions
  3. Regularly review moderation cases and statistics
  4. Use role persistence for users with important roles
  5. Use /modstats to monitor moderator performance
  6. Document patterns and trends for improvement
  7. Maintain consistent enforcement of server rules

Table of contents