Role ReactorFirst Steps
Get started with Role Reactor Bot by creating your first role message and understanding how it works.
Quick Start Tutorial
This tutorial will guide you through creating your first role message using Role Reactor Bot.
Prepare Roles
Before creating a role message, ensure the roles you want to use exist in your server. For this example, we'll use:
- Gamer - For gaming enthusiasts
- Artist - For creative members
- Developer - For tech-minded people
Prerequisite: These roles must exist in your server before creating the role message. Create them in Server Settings > Roles if needed.
Create the Role Message
In any channel where you want the role message to appear, execute:
/role-reactions setup title:Choose Your Roles description:React below to assign yourself roles! roles:š®:Gamer,šØ:Artist,š»:DeveloperCommand Breakdown:
title:Choose Your Roles- Sets the message titledescription:React below to assign yourself roles!- Provides instructionsroles:š®:Gamer,šØ:Artist,š»:Developer- Defines emoji-role pairs
Formatting Note: Ensure there are no extra spaces around commas in the roles string. Use š®:Gamer,šØ:Artist not š®:Gamer, šØ:Artist.
Test Functionality
- Locate the newly created message in the channel
- Click the š® reaction - you should receive the "Gamer" role
- Verify the role appears in your member sidebar
- Remove the reaction to confirm the role is removed
Success: Your members can now self-assign roles by reacting to your message.
Enhanced Customization
Improve the appearance of your role message with custom formatting and descriptions:
/role-reactions setup title:š Community Roles description:**Welcome to our server!**\n\nChoose roles that match your interests:\n\nā¢ š® Gaming enthusiasts\nā¢ šØ Creative minds\nā¢ š» Tech lovers roles:š®:Gamer,šØ:Artist,š»:Developerš Community Roles
Welcome to our server!
Choose roles that match your interests:
ā¢ š® Gaming enthusiasts
ā¢ šØ Creative minds
ā¢ š» Tech lovers
š® šØ š»Formatting Features Used:
- Bold text with
**bold** - Line breaks with
\n - Bullet points with
ā¢
User Experience
When you create a role message, members will see:
Member Interaction Flow
- View the message in the channel
- Read the description to understand emoji meanings
- Click emoji reactions to assign roles
- Remove reactions to remove roles
- Verify roles in their profile
Category Organization
For servers with multiple roles, organize them into categories:
/role-reactions setup title:Server Roles description:Choose your roles by category! roles:#Gaming\nš®:Gamer,š²:Board Games,š¹ļø:Retro Gaming\n#Creative\nšØ:Artist,šø:Photographer,āļø:WriterServer Roles
Choose your roles by category!
āāāāāāā Gaming āāāāāāā
š® Gaming enthusiasts
š² Board game lovers
š¹ļø Retro gaming fans
āāāāāāā Creative āāāāāāā
šØ Artists and designers
šø Photography enthusiasts
āļø Writers and storytellers
š® š² š¹ļø šØ šø āļøAdvanced Features
After setting up basic role management, explore these additional capabilities:
Temporary Roles
Assign time-limited roles with automatic expiration:
/temp-roles assign users:@user1,@user2 role:@TrialMember duration:7d reason:Free trial periodScheduled Roles
Assign roles at specific times or create recurring schedules:
/schedule-role create action:assign role:@EventParticipant users:@user1 schedule-type:one-time schedule:tomorrow 8amWelcome System
Automatically welcome new members with customizable messages:
/welcome setup channel:#welcome message:Welcome {user} to {server}! š auto-role:@Member enabled:trueXP System
Track member activity with experience points:
/xp settingsTroubleshooting
Common Issues
"The bot didn't respond to my command"
- Verify the bot has permission to send messages in that channel
- Confirm the command syntax is correct (start with
/role-reactions setup)
"Members can't get roles when they react"
- Verify role names match exactly (case-sensitive)
- Ensure the bot's role is positioned above the roles it's trying to assign
- Confirm the bot has "Manage Roles" permission
"The emoji reactions didn't appear"
- The bot requires "Add Reactions" permission
- Custom emojis may not be available to the bot
Quick Resolution Steps
- Verify bot permissions in channel settings
- Check role hierarchy in Server Settings > Roles
- Test with simple role names (avoid special characters)
Next Steps:
- Review Example Setups for your server type
- Explore Command Documentation for advanced features
- Visit Troubleshooting Guide for additional support