Moderation Quick Start

Get the Moderation cog set up and running in a few steps.

1. Enable the Cog

Run /config cog Moderation and toggle the cog on. This enables the moderation system for your server.

2. Set Up Logging

In /config guild, set a Log Channel. All moderation actions (bans, mutes, warns, kicks, etc.) are posted there as embeds with full details.

Alternatively, run /moderation config and set the log channel within the moderation-specific configuration panel.

3. Configure Moderation Settings

Run /moderation config to open the interactive configuration panel. Key settings to review:

Setting Purpose
Ban Commands Enabled Toggle /ban and /unban on or off
Kick Command Enabled Toggle /kick on or off
Mute Commands Enabled Toggle /mute and /unmute on or off
Comped Enabled Toggle /comped (compromised account handler) on or off
Muted Role The role applied to muted users (required for /mute)
Mute Allowed Roles Roles that can use /mute without Manage Roles permission
Warn Allowed Roles Roles that can use /warn without Manage Messages permission
Role Persist Allowed Roles Roles that can use /rolepersist
Punishment Protected Roles Roles that cannot be targeted by any moderation action

4. Set Up a Mute Role

Before /mute will work, a mute role must be configured:

  1. Create a role in your server (e.g., “Muted”)
  2. Position it below the bot’s role in Server Settings - Roles
  3. In each channel (or via a channel category), deny Send Messages, Add Reactions, and Speak for the mute role
  4. Run /moderation config and set the Muted Role to your new role

5. Test the Basics

Try these commands to confirm everything is working:

/warn @User Breaking server rules
/mute @User 30m Repeated spam
/whois @User
/modlogs @User

6. Optional: Set a Ban Appeal Message

If you want users to receive an appeal link when banned, run:

/moderation ban_appeal_message

This opens a modal where you can enter the message appended to all ban DMs.

7. Next Steps

  • Add Preset Reasons for common moderation scenarios
  • Set up Modlog Sharing for multi-server communities
  • Review the Features Reference for mute persistence, role persist, and auto-expiry details
  • Use /moderation help to browse all available commands with examples