Permissions Configuration

Comprehensive guide for setting up and managing permissions in Central Bot.

Permission Hierarchy

markdown
Permission Levels (Highest to Lowest):
• Administrator : Full bot access
• High Rank     : Administrative commands
• Moderator     : Moderation commands
• Staff         : Basic staff features
• Members       : Basic commands

Required Permissions

Discord permissions needed for bot functionality:

markdown
Server Permissions:
• Manage Server
• Manage Roles
• Manage Channels
• Manage Messages
• View Channels
• Send Messages
• Embed Links
• Attach Files
• Read Message History
• Add Reactions
• Use External Emojis
• Timeout Members (for moderation)

Role Configuration

Administrative Roles

  • Administrator: Full bot configuration access
  • High Rank: Staff management, infractions
  • Moderator: Basic moderation commands

Feature-Specific Roles

  • Server Starter: Session management
  • API Moderator: Game server moderation
  • API Admin: Game server administration
  • Staff: Basic staff features

Module-Specific Permissions

markdown
Sessions:
• Server Starter+ : All session commands
• Staff+          : Session voting

Staff Management:
• High Rank+      : Issue infractions
• High Rank+      : Staff promotions

Moderation:
• Moderate Members : Warnings, timeouts
• Kick Members     : Kick command
• Ban Members      : Ban command

Economy:
• Manage Guild     : Economy management
• Everyone         : Basic economy commands

API Integration:
• API Moderator    : Game moderation
• API Admin        : Game administration

Channel Permissions

Required channel configurations:

markdown
Logs Channel:
• Bot    : Send Messages, Embed Links
• Staff  : View Channel
• Members: Cannot View Channel

Welcome Channel:
• Bot    : Send Messages, Embed Links
• Everyone: View Channel

Staff Channels:
• Bot    : Full Access
• Staff+ : View & Send
• Members: Cannot View

Permission Checks

Regularly verify these permission configurations:
  • Bot role hierarchy
  • Channel access settings
  • Role assignments
  • Command access
  • Module permissions

Setting Up Permissions

  1. Configure initial High Rank role
  2. Set up staff hierarchy
  3. Configure module-specific roles
  4. Set channel permissions
  5. Test access levels

Best Practices

Follow these guidelines for secure permission management:
  • Follow principle of least privilege
  • Regular permission audits
  • Document role hierarchy
  • Test after changes
  • Monitor permission usage

Common Issues

markdown
Troubleshooting:
• Command Access Denied
  - Verify role assignments
  - Check channel permissions
  - Confirm bot hierarchy

• Module Access Issues
  - Check module configuration
  - Verify required roles
  - Review channel settings

• Permission Conflicts
  - Check role hierarchy
  - Review override settings
  - Verify bot permissions

Permission Commands

configAdministrator

Configure role permissions

Usage: /config
Proper permission configuration ensures smooth bot operation and server security.
Module Configuration →Moderation Guide →