Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.celestia.rest/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
~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
Remove a role’s permission for a specific command.
~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
View all role permissions in your server.
~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
Clear all role permissions in your server.
~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

# 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

​
Common Use Cases

# 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.
# 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.
# 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.
# 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

Enable/Disable Commands

Control which commands are available server-wide

Role Management

Create and manage server roles