Role ReactorSetup Guide
Complete setup guide for Role Reactor Bot - from installation to creating your first role messages
Quick Start
Formatting Note: When creating role strings, avoid extra spaces around commas and ensure each emoji is unique. Use đŽ:Gaming,đ¨:Art not đŽ:Gaming, đ¨:Art.
Invite the Bot
Add Role Reactor Bot to your server
Ensure the following permissions are granted:
- Manage Roles
- Manage Messages
- Send Messages
- Add Reactions
- Read Message History
- View Channel
- Embed Links
- Manage Server
- Use External Emojis
Create Your First Role Message
/role-reactions setup title:Server Roles description:Choose your roles below! roles:đŽ:Gaming,đ:Books,đĩ:MusicVerify Functionality
Test the role message by clicking reactions to confirm roles are assigned and removed correctly.
Setup complete. You now have a functional role system. Continue reading for advanced configuration options.
Permission Requirements
Required Permissions
The bot requires the following permissions to function:
Manage Roles
Assign and remove roles from members
Manage Messages
Manage role-reaction messages
Add Reactions
Add emoji reactions to messages
Read Message History
Monitor reaction events and read channel history
View Channel
Access channels where the bot operates
Send Messages
Create role selection messages and respond to commands
Embed Links
Create rich embedded messages
Manage Server
Manage server settings and configurations
Use External Emojis
Use emojis from other servers
Permission Configuration
- During Invitation: Select all required permissions when inviting the bot
- Post-Installation: Verify bot permissions in Server Settings > Roles
- Role Position: Ensure the bot's role is positioned above any roles it manages
Important: The bot can only manage roles that are positioned below its own role in the server hierarchy.
Creating Role Messages
Basic Role Message
Basic role list:
/role-reactions setup title:Choose Your Roles description:React to get roles! roles:đŽ:Gaming,đ:Reading,đĩ:Music,đ¨:ArtOutput:
Choose Your Roles
React to get roles!
đŽ đ đĩ đ¨Organized with categories:
/role-reactions setup title:Game Roles description:Choose your favorite games! roles:đ´:Valorant,âĄ:Apex Legends,âī¸:League of LegendsOutput:
Game Roles
Choose your favorite games!
đ´ ⥠âī¸Full customization:
/role-reactions setup title:đ Community Roles description:**Welcome!** Choose your roles below.\n\n*You can select multiple roles.* roles:#Gaming đŽ\nđĨī¸:PC Gaming,đŽ:Console,đą:Mobile\n#Creative đ¨\nđ¨:Art,đ¸:Photo,đĩ:MusicCategory Organization
Organize roles into categories for improved user experience:
Category Header
Begin with #Category Name to create a section header
Add Roles
List roles under each category: emoji:role1,emoji:role2
Multiple Categories
Separate categories with \n for new lines
Example Structure:
#Gaming Platforms
đĨī¸:PC Gaming,đŽ:Console Gaming,đą:Mobile Gaming
#Notifications
đĸ:Announcements,đ:Events,đ°:News
#Interests
đ¨:Art,đ:Books,đĩ:MusicRole Message Management
Managing Existing Messages
Edit Message
/role-reactions update - Update title, description, or roles
Delete Message
/role-reactions delete - Remove a role message
List Messages
/role-reactions list - View all role messages
Refresh Reactions
Contact support - Fix broken reactions
Role Color Configuration
Setting Role Colors:
Roles are created through Discord's server settings. The bot can only manage existing roles.
- Navigate to Server Settings > Roles
- Create new roles with your desired colors
- Use the bot to assign these roles via reactions
Color Guidelines:
- Use hex color codes (#FF0000) for precise control
- Group related roles in similar color families
- Ensure sufficient contrast for readability
- Consider colorblind accessibility
Server Organization
Recommended Channel Structure
đ INFORMATION
âââ đ rules
âââ đĸ announcements
âââ đ get-roles
đŦ GENERAL
âââ đŦ general-chat
âââ đŽ gaming
âââ đĩ musicRole Channel Best Practices
Recommendation: Create a dedicated #get-roles channel for optimal user experience.
Channel Configuration:
- Create a channel named
#get-rolesor#roles - Configure permissions (everyone can view, limited sending)
- Pin important role messages
- Add channel description explaining reaction usage
Channel Description Example:
đ Role Selection
React to the messages below to get roles!
âĸ Click an emoji to get that role
âĸ Click again to remove the role
âĸ You can have multiple roles
âĸ Ask in #general if you need helpAdvanced Configuration
Role Hierarchy Management
Important Rules:
- Bot's role must be positioned above managed roles
- Higher roles in the list have more permissions
- Exercise caution with administrative roles
Hierarchy Setup:
- Navigate to Server Settings > Roles
- Drag the bot's role above any roles it should manage
- Arrange other roles by importance
- Test role assignment to verify functionality
Multiple Role Messages
For larger servers, create multiple focused role messages:
Message 1: Essential Roles
/role-reactions setup title:Essential Roles roles:đĸ:Announcements,đ:Events,đŦ:General ChatMessage 2: Interests
/role-reactions setup title:Your Interests roles:#Hobbies\nđŽ:Gaming,đ:Reading,đĩ:Music,đ¨:ArtMessage 1: Gaming Platforms
/role-reactions setup title:Gaming Platforms roles:đĨī¸:PC,đŽ:PlayStation,đ¯:Xbox,đą:Mobile,đšī¸:NintendoMessage 2: Game Types
/role-reactions setup title:Game Genres roles:#Genres\nđĢ:FPS,âī¸:RPG,đī¸:Racing,đ˛:Strategy,đĨ:MMOMessage 3: Activity
/role-reactions setup title:Playstyle roles:#Playstyle\nđ:Competitive,đ¯:Casual,đĨ:Looking for GroupMessage 1: Subjects
/role-reactions setup title:Study Subjects roles:#Subjects\nđ:Math,đŦ:Science,đ:English,đī¸:HistoryMessage 2: Study Groups
/role-reactions setup title:Study Style roles:#Study Style\nđĨ:Group Study,đ¤Ģ:Solo Study,đ
:Study ScheduleTroubleshooting
Common Issues
Bot Not Responding
- Verify bot permissions
- Check bot role position
- Confirm bot is online
Roles Not Being Assigned
- Verify role hierarchy (bot role above target roles)
- Confirm role names match exactly
- Test with a simple role first
Reactions Not Working
- Contact support to fix reactions
- Verify emojis are from the server or Unicode
- Confirm bot can add reactions in the channel
Additional Support
If issues persist:
- Review the Troubleshooting section for detailed solutions
- Join our support server for community assistance
- Report bugs through our GitHub issues page
Setup Complete: Your Role Reactor Bot is now configured and ready to use. Visit the Examples section for inspiration on creating engaging role systems for your community.