Moderation Cog

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

Moderation Actions

  • Bans: Permanent or temporary bans with reasons
  • Mutes: Time-based mutes with automatic unmute
  • Timeouts: Discord’s built-in timeout feature
  • Warnings: Verbal warnings with case tracking
  • Kicks: Remove users from the server
  • Unbans: Remove bans and allow rejoining

Case Management

  • Case Numbers: Automatic incrementing case IDs
  • Case History: Complete history of moderation actions per user
  • Case Editing: Modify existing cases and reasons
  • Case Deletion: Remove cases with audit trails
  • Bulk Operations: Handle multiple users at once

Advanced Features

  • Role Persistence: Maintain roles when users leave/rejoin
  • Mass Actions: Ban/kick multiple users simultaneously
  • Reason Templates: Predefined reason options
  • Duration Parsing: Flexible time format parsing (1d, 2h, 30m, etc.)
  • Moderator Tracking: Log who performed each action

Logging & Audit

  • Modlog Channel: Dedicated channel for moderation logs
  • Embed Formatting: Rich embeds with user info and timestamps
  • Audit Trails: Track all changes to cases
  • Export Options: Export moderation data

User Information

  • User Lookup: Detailed user information including flags
  • Avatar Display: Show user avatars in logs
  • Account Age: Display account creation dates
  • Server Join Date: Track when users joined your server

Commands

Command Description Permissions
/mod ban <user> <reason> Ban a user Ban Members
/mod mute <user> <duration> <reason> Mute a user Moderate Members
/mod timeout <user> <duration> <reason> Timeout a user Moderate Members
/mod warn <user> <reason> Warn a user Manage Messages
/mod kick <user> <reason> Kick a user Kick Members
/mod case <id> View a specific case Manage Messages
/mod cases <user> View user’s case history Manage Messages
/mod edit <id> <reason> Edit a case reason Manage Messages
/mod delete <id> Delete a case Manage Messages

Configuration

  • Modlog Channel: Where moderation actions are logged
  • Default Reasons: Preset reason options
  • Role Permissions: Custom role requirements
  • Logging Preferences: What actions to log

Integration

The moderation cog integrates with:

  • Notes System: Attach notes to moderation cases
  • Alt Tracker: Check for alternate accounts
  • Reputation System: Consider reputation in moderation decisions
  • Vor Sentinel: Enhanced automod capabilities

Best Practices

  1. Clear Reasons: Always provide detailed reasons for actions
  2. Consistent Formatting: Use standard reason formats
  3. Case Review: Regularly review moderation cases
  4. Escalation: Use progressive discipline when appropriate
  5. Documentation: Keep detailed records for appeals

Security Features

  • Permission Validation: Multi-layer permission checking
  • Action Logging: All actions are logged with timestamps
  • Audit Prevention: Cannot delete audit logs
  • Rate Limiting: Prevents abuse of moderation commands