Role Permissions (Permit)

Grant specific roles permission to use restricted commands

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

permit add

Allow a role to use a specific command.

Syntax

~permit add <role> <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

permit remove

Remove a role’s permission for a specific command.

Syntax

~permit remove <role> <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

permit list

View all role permissions in your server.

Syntax

~permit list

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

permit clear

Clear all role permissions in your server.

Syntax

~permit clear

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:

   ~permit add @Moderators ban
   ~permit add @Moderators kick
   ~permit add @Helpers warn
   
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:

   # View all permits
   ~permit list
   
   # Remove specific permit
   ~permit remove @Helpers warn
   
   # Clear everything
   ~permit clear
   

---

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

Moderation Team

# Grant moderator commands
~permit add @Moderators ban
~permit add @Moderators kick
~permit add @Moderators mute
~permit add @Moderators warn

# Grant helper commands
~permit add @Helpers warn
~permit add @Helpers mute

# View configuration
~permit list

Staff Hierarchy

# Senior staff gets full access
~permit add @Senior ban
~permit add @Senior kick
~permit add @Senior mute

# Junior staff gets limited access
~permit add @Junior warn
~permit add @Junior mute

# Trial staff gets minimal access
~permit add @Trial warn

Specialized Roles

# Event managers
~permit add @EventManager announce
~permit add @EventManager giveaway

# Support team
~permit add @Support ticket
~permit add @Support close

# Content moderators
~permit add @ContentMod purge
~permit add @ContentMod warn

Management

# View all permits
~permit list

# Remove specific permission
~permit remove @Helpers mute

# Clear all permits
~permit clear

Using Role IDs

# Add using role ID
~permit add 123456789012345678 ban

# Add using role name
~permit add Moderators kick

# Add using mention
~permit add @Staff warn

---

Common Use Cases

Delegate moderation without full permissions

# Give mods ban command without Ban Members permission
~permit add @Moderators ban

# Give helpers warn without Manage Messages
~permit add @Helpers warn

Allows command access without granting Discord permissions.

Create tiered staff structure

# Senior staff - full access
~permit add @Senior ban
~permit add @Senior kick
~permit add @Senior mute

# Junior staff - limited access
~permit add @Junior warn
~permit add @Junior timeout

Different permission levels for different staff tiers.

Specialized role access

# Event coordinators
~permit add @Events giveaway
~permit add @Events announce

# Support team
~permit add @Support ticket

Grant access to specific features based on role purpose.

Temporary permissions

# Grant temporary access
~permit add @Trial warn

# Remove after trial period
~permit remove @Trial warn

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

---

Related Features

Enable/Disable Commands

Control which commands are available server-wide

Role Management

Create and manage server roles