Permission System

Raptor uses a custom role-based permission system instead of Discord's native permissions. This provides more flexibility and control over who can use specific commands.

Permission Roles

Raptor recognizes three levels of moderator roles:

1. Trial Mod Role

The entry-level moderation role with limited permissions.

Setup:

/settings trial_mod @TrialMod

Capabilities:

  • Can use basic moderation commands (with restrictions)
  • Limited warning system access

2. Mod Role

The standard moderator role with full moderation access.

Setup:

/settings modrole @Moderator

Capabilities:

  • Full access to moderation commands
  • Warning system management
  • Message filtering
  • Channel management

3. Admin Role

The highest-level role for server administrators.

Setup:

/settings adminrole @Administrator

Capabilities:

  • All moderation capabilities
  • Server settings configuration
  • Full system access

Default Permissions

Each command specifies which Discord permission it requires as a baseline. However, having the Discord permission is not enough, you must also have the appropriate Raptor role configured.

Common permission requirements:

  • Manage Messages - For moderation and filtering commands
  • Kick Members - For kick commands
  • Ban Members - For ban/unban commands
  • Manage Roles - For role-related commands
  • Manage Channels - For channel management
  • Manage Server - For configuration commands

How Permissions Work

The permission check follows this logic:

  1. Discord Permission Check: Does the user have the required Discord permission?
  2. Raptor Role Check: Does the user have the configured moderator role?
  3. Command Execution: If both checks pass, the command executes

Both Checks Required

Users must have BOTH the Discord permission AND the configured Raptor role to use moderation commands.

No Permission Required

Some commands don't require any special permissions and can be used by anyone:

  • /ping - Check bot status
  • /motd - View message of the day
  • /feedback - Send feedback
  • /about - Bot information
  • /serverinfo - Server information
  • /whois - User information
  • /spotify - Spotify status
  • /eightball - Fun command
  • /autorole list - View autorole list

Best Practices

  1. Assign roles carefully - Only give moderator roles to trusted members
  2. Use role hierarchy - Trial mods for users getting started, full mods for experienced staff
  3. Audit regularly - Check who has moderator roles regularly
  4. Document your setup - Keep notes on which roles are assigned to whom