Reaction Roles

Simplify role management with automatic role assignment through reactions and interactive buttons.

Key Features

• Reaction-Based Roles: Assign roles when users react to specific messages
• Button Interfaces: Modern Discord buttons for cleaner role selection
• Multiple Role Types: Self-assignable, exclusive groups, and requirement-based roles
• Custom Restrictions: Require specific roles or levels before allowing role assignment
• Auto-Remove: Remove roles when reactions are removed
• Bulk Management: Set up multiple roles on a single message

Setup Commands

• /reactionroles create - Create a new reaction role message
• /reactionroles add - Add role assignments to existing messages
• /reactionroles remove - Remove role assignments
• /reactionroles edit - Modify existing reaction role setups
• /reactionroles list - View all active reaction role messages
• /reactionroles test - Test role assignment functionality

Role Types

• Standard Roles: Basic role assignment and removal
• Exclusive Groups: Users can only have one role from a group
• Additive Roles: Multiple roles can be selected simultaneously
• Requirement Roles: Require other roles before allowing assignment
• Level Gates: Require minimum server level for role access
• Time-Limited: Temporary roles that expire automatically

Advanced Features

• Role Categories: Organize roles by purpose (colors, games, notifications)
• Permission Checks: Ensure bot can manage target roles
• Audit Logging: Track all role changes and assignments
• Custom Messages: Personalized confirmation and error messages
• Embed Designer: Create attractive role selection interfaces
• Analytics: Track role assignment patterns and popularity

Common Use Cases

• Color Roles: Let users choose their display color
• Game Roles: Roles for different games or interests
• Notification Roles: Opt-in roles for announcements
• Pronoun Roles: Self-assignable pronoun roles
• Region Roles: Geographic or timezone-based roles
• Access Roles: Roles that grant access to private channels

Configuration Options

• Maximum roles per user
• Role hierarchy restrictions
• Channel permissions for role assignment
• Custom emoji and button styles
• Automatic role cleanup settings
• Integration with leveling system

Perfect for servers wanting to give users control over their roles while maintaining organization and security.