Skip to main content

​
Overview

The permit system allows you to grant specific roles permission to use commands that would normally require certain permissions. This creates a flexible permission structure where you can delegate command access without granting full Discord permissions.
Permits work alongside Discord permissions - they grant additional access, not replace existing permission requirements.

​
Commands

Allow a role to use a specific command.
Parameters:
  • role — Role mention, ID, or name
  • command — Command name to grant access to
What It Does:
  • Grants the role permission to use the command
  • Works with role mentions, IDs, or names
  • Multiple commands can be added per role
Aliases: rolepermit add, cmdpermit add
Permissions: Administrator
Remove a role’s permission for a specific command.
Parameters:
  • role — Role mention, ID, or name
  • command — Command name to revoke access from
What It Does:
  • Removes the role’s permission for the command
  • Role can no longer use that command
  • Other permits for the role remain intact
Aliases: rolepermit remove, cmdpermit remove
Permissions: Administrator
View all role permissions in your server.
What It Shows:
  • All roles with command permissions
  • Which commands each role can use
  • Paginated display (10 entries per page)
  • Total count of permits
Aliases: rolepermit list, cmdpermit list
Permissions: Administrator
Clear all role permissions in your server.
What It Does:
  • Removes ALL role permits from the server
  • Shows count of cleared roles
  • Cannot be undone
This removes all permit configurations. Use permit remove for individual permissions.
Aliases: rolepermit clear, cmdpermit clear
Permissions: Administrator

​
How It Works

1

Grant Role Permissions

Add permissions for roles to use specific commands:
2

Members Get Access

Users with those roles can now use the commands:
  • Members with @Moderators can use ban and kick
  • Members with @Helpers can use warn
  • Permissions stack with Discord permissions
3

Manage Permits

View, remove, or clear permissions as needed:

​
Role Resolution

The system accepts roles in multiple formats:
  1. Mention — @Moderators (most reliable)
  2. Role ID — 123456789012345678
  3. Role Name — Moderators (case-insensitive)
If multiple roles have similar names, use mention or ID for accuracy.

​
Permission Requirements

Bot Permissions

No special permissions required beyond basic message reading and sending.

User Permissions

Command Requirements:
  • Administrator — Required for all permit commands

​
Aliases

All permit commands support multiple aliases:

permit

Main command

rolepermit

Role-focused alias

cmdpermit

Command-focused alias

​
Usage Examples

​
Common Use Cases

Allows command access without granting Discord permissions.
Different permission levels for different staff tiers.
Grant access to specific features based on role purpose.
Easy to add and remove as needed.

​
Important Notes

Permission Stacking
  • Permits grant ADDITIONAL access
  • They do not override Discord permissions
  • Bot still needs required permissions
  • Users still need basic channel access
Best Practices
  • Use specific role names to avoid confusion
  • Document which roles have which permits
  • Review permits regularly with permit list
  • Remove permits when roles change

Enable/Disable Commands

Control which commands are available server-wide

Role Management

Create and manage server roles