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
hide_list (optional)
Hide the automatic list of available roles at the bottom of 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
hide_list (optional)
Hide the automatic list of available roles at the bottom of the embed
Role Format Tips
Role Format Options:
- @RoleName — Use @ symbol (e.g.,
🎮:@Gamer) - RoleName — Use role name directly (e.g.,
🎮:Gamer) - "Role Name" — Use quotes for spaces (e.g.,
💬:"Gaming Role") - [@Role1, @Role2] — Create inline multi-role arrays (e.g.,
💡:[@Mod, @Admin]) - [BundleName] — Import a saved Role Bundle (e.g.,
🚀:[StarterPack]) - emoji:role:limit — Set a maximum number of users per role (e.g.,
🎮:Gamer:10)
Examples:
🎮:@Gamer,🎨:@Artist— Using @ symbol🎮:Gamer,🎨:Artist— Direct role names🎮:"Gaming Role",🎨:"Art Role"— Quoted names with spaces💡:[@Moderator, @Admin]— Inline multi-role array🚀:[StarterPack]— Import a Role Bundle🎮:Gamer:10,🎨:Artist:5— With user limits
Available Colors
- Default — Soft lavender (
#9b8bf0) - Neon Blue — Bright cyberpunk blue
- Matrix Green — Iconic digital rain green
- Cyber Red — Aggressive cyberpunk red
- Electric Yellow — Pure electric yellow
- Quantum Purple — Mystical quantum purple
- Plasma Orange — Hot plasma orange
- Synth Pink — Synthetic digital pink
- Hologram Cyan — Holographic cyan
- Steel Brown — Industrial steel brown
- Chrome Gray — Polished chrome gray
Tier Limitations
- Active Menus per Server: 3 Menus (Free) | 20 Menus (Pro Engine)
- Emojis per Menu: 10 Emojis (Free) | 20 Emojis (Pro Engine)
- Roles per Bundle/Array: 5 Roles (Free) | 15 Roles (Pro Engine)
Step-by-Step Example
- Select roles and emojis for your message.
- Execute the command:
bash /role-reactions setup title:Choose Your Roles description:React to get roles! roles:🎮:@Gamer, 🎨:@Artist3. The bot will create an interactive message that users can react to.
Using @ symbol for role mentions: bash /role-reactions setup title:Game Roles description:Pick your role! roles:🎮:Gamer, 🎨:Artist
Update an existing message: bash /role-reactions update message_id:1234567890 title:Updated Title
List all role-reaction messages: bash /role-reactions list
Permissions 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
/role-bundle
Create reusable role bundles for role-reaction setups
/temp-roles
Manage temporary role assignments
/schedule-role
Schedule role assignments
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.