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
Role Format Tips
Role Format Options:
- @RoleName - Use @ symbol (e.g.,
@Gamer) - RoleName - Use role name directly (e.g.,
Gamer) - Role Mention - Use role mention format (e.g.,
<@&123456789>) - "Role Name" - Use quotes for spaces (e.g.,
"Gaming Role")
Examples:
🎮:@Gamer,🎨:@Artist- Using @ symbol🎮:Gamer,🎨:Artist- Direct role names🎮:"Gaming Role",🎨:"Art Role"- Quoted names with spaces
Step-by-Step Example
- Select roles and emojis for your message.
- Execute the command:
/role-reactions setup title:Choose Your Roles description:React to get roles! roles:🎮:@Gamer, 🎨:@Artist- The bot will create an interactive message that users can react to.
Using @ symbol for role mentions:
/role-reactions setup title:Game Roles description:Pick your role! roles:🎮:Gamer, 🎨:ArtistUpdate an existing message:
/role-reactions update message_id:1234567890 title:Updated TitleList all role-reaction messages:
/role-reactions listPermissions Required
- Manage Roles: Required to create and manage role-reaction messages
Troubleshooting
- Bot not posting message: Verify bot permissions (Manage Roles, Send Messages, Add Reactions).
- Roles not assigned: Ensure the bot's role is positioned above the target roles in the Discord role list.
- Emoji not working: Use standard emoji or custom emoji accessible to the bot.
- Message not found: Verify the message ID is correct and the message still exists.
Related Commands
What You'll See
Interactive role assignment via emoji reactions with customizable embeds, automatic reaction addition, and comprehensive management tools!
Best Practices
- Maintain manageable role lists (5-12 per message is recommended).
- Use clear, descriptive role names and appropriate emojis.
- Test your setup with a test user before deployment.
- Regularly clean up unused role-reaction messages.
- Use the update command to modify existing messages instead of creating new ones.