01
Create Bot Roles
For optimal functionality, ZygnalBot requires two specific roles:
- Bot Role (Top Hierarchy) - Contains all permissions needed for operation
- Secondary Role (Bottom Hierarchy) - Used for organizational purposes
02
Configure Top Role
The main bot role needs specific permissions and positioning:
- Go to Server Settings > Roles
- Create a "Bot Permissions" role
- Enable all required permissions (Admin recommended for full functionality)
- Move this role to the top of hierarchy, just below the server owner
- This positioning is crucial for the Anti-Nuke system to function properly
03
Setup Secondary Role
The secondary role controls the bot's position in the member list:
- Create a second organizational role
- No permissions are needed for this role
- Place at the bottom of hierarchy or at your preferred position
- This determines the bot's position in the member list
04
Assigning Roles to the Bot
- Go to your Discord server and click on the Members list
- Find your bot in the list of server members
- Right-click on the bot's name, then click on Roles
- Assign both the Bot Role (top of hierarchy) and Secondary Role (lowest in hierarchy)
05
Sorting by Hierarchy
- After assigning the roles, ensure they are sorted correctly by hierarchy
- In the Role Settings, under the Roles section, the topmost role will have the highest priority
- The lowest role will have the lowest priority
- Ensure your bot's main role is at the top, just below server owner
06
Adjusting Permissions
- If your bot is not able to access certain channels or perform actions, check role priority
- Make sure no other roles with higher priority restrict access to necessary permissions
- Verify channel-specific permission overrides aren't blocking the bot
Why Two Roles for the Bot?
This dual-role system serves several important purposes:
- Security: Separates permissions from visual positioning
- Organization: Allows you to control where the bot appears in the member list
- Functionality: Ensures the bot has proper permissions while maintaining your preferred server structure
- Anti-Nuke Protection: The top role position is crucial for the bot to override and prevent unauthorized administrative actions
Final Steps
- Test the bot: Once roles are set up, test the bot by asking it to perform tasks to ensure it has the required permissions
- Sort Roles: Ensure roles are sorted in the correct order in Server Settings > Roles tab
- Check Functionality: Verify that all commands and features are working as expected
Back to Home