Role ReactorRole Reactions
Manage role reaction messages for self-assignable roles. Create interactive role selection messages that users can react to.
Subcommands
setup
Create a new role-reaction message
list
List all existing role-reaction messages
delete
Delete a role-reaction message
update
Update an existing role-reaction message
Parameters
Setup Subcommand
title (required)
Title of the role message
description (required)
Description of the role message
roles (required)
Comma-separated emoji:role pairs (e.g., š®:Gamer,šØ:Artist)
color (optional)
Choose a color for the embed
List Subcommand
No parameters required
This command lists all existing role-reaction messages
Delete Subcommand
message_id (required)
The ID of the message to delete
Update Subcommand
message_id (required)
The ID of the message to update
title (optional)
New title for the message
description (optional)
New description for the message
roles (optional)
New comma-separated emoji:role pairs
color (optional)
New color for the embed
Formatting Tips
Important: When formatting the roles string, avoid extra spaces around commas. Use consistent formatting:
- ā
Correct:
š®:Gaming,šØ:Art,šµ:Music - ā Avoid:
š®:Gaming, šØ:Art, šµ:Music(extra spaces) - ā Avoid:
š®:Gaming,šØ: Art,šµ:Music(inconsistent spacing)
Step-by-Step Example
- Choose roles and emojis for your message.
- Run the command:
/role-reactions setup
title:"Choose Your Roles"
description:"React to get access to channels!"
roles:"š®:Gaming,š:Books,šµ:Music"- The bot will create an interactive message that users can react to.
Perfect for gaming communities:
/role-reactions setup
title:"Gaming Roles"
description:"Select your favorite games to get access to game channels!"
roles:"š®:Minecraft,āļø:Valorant,šļø:Racing,šÆ:FPS,š²:Board Games"
color:"#00ff00"Great for general communities:
/role-reactions setup
title:"Community Roles"
description:"Choose your interests and notification preferences"
roles:"#Interests\nš®:Gaming\nš:Books\nšµ:Music\n#Notifications\nš¢:News\nš:Events"
color:"#0099ff"Update an existing message:
/role-reactions update
message_id:123456789012345678
title:"Updated Role Selection"
roles:"š®:Gaming,š:Books,šµ:Music,šØ:Art"Permissions Required
- Manage Roles: Required to assign/remove roles from users
- Send Messages: Required to post the role message
- Add Reactions: Required to add reaction emojis
- Embed Links: Required to create rich embeds
Troubleshooting
- Bot not posting message: Check bot permissions (Manage Roles, Send Messages, Add Reactions).
- Roles not assigned: Ensure the bot's role is above the target roles in the Discord role list.
- Emoji not working: Use standard emoji or custom emoji the bot has access to.
- Message not found: Make sure the message ID is correct and the message still exists.
Related Commands
Best Practices
- Keep role lists manageable (5-12 per message is ideal).
- Use clear, descriptive role names and appropriate emojis.
- Test your setup with a test user before going live.
- Regularly clean up unused role-reaction messages.