Introduction

Overview

Role Reactor Bot provides a complete server management system — from self-assignable roles and auto-moderation to ticketing, giveaways, and experience tracking. Members interact with embedded messages by clicking emoji reactions, which automatically assigns or removes corresponding roles in real-time.

Key Benefits

Simplified User Experience

Members can assign roles without learning commands or waiting for administrator approval. The process requires three simple steps:

1. View the role selection message
2. Click the desired emoji reaction
3. Receive the role automatically

Rapid Deployment

Role selection messages can be created in seconds using a single command. The bot handles message creation, reaction management, and role assignment automatically without requiring technical configuration.

Customization Options

Administrators can customize role messages with:

• Custom embed colors and formatting
• Organized category sections
• Rich markdown descriptions
• Professional embedded appearance

Security and Reliability

The bot operates within Discord's permission framework and includes:

• Full compliance with Discord's permission system
• Respect for server role hierarchy
• Graceful error handling
• 24/7 reliable operation

Use Cases

Common Implementation Patterns

Interest-Based Organization

Enable members to identify their hobbies, interests, or specialties:

• Gaming preferences (PC Gamer, Console Player)
• Creative interests (Artist, Photographer, Writer)
• Technology focus (Developer, Cybersecurity, AI Enthusiast)

Notification Management

Provide members with control over notification preferences:

• Announcements - Server news and updates
• Events - Community events and activities
• Mentions - Direct mentions and help requests

Activity Classification

Help members find others with similar availability:

• Very Active - Online most days
• Night Owl - Active during late hours
• Mobile User - Primarily mobile access

Server Organization

Organize members into logical groups:

• Academic vs Professional roles
• Geographic time zones (Americas, Europe, Asia)
• Experience levels (Beginner, Intermediate, Expert)

Core Features

Command-Based Setup

Role messages are created using a single command:

/role-reactions setup title:Your Title description:Your description roles:🎮:Gamer,🎨:Artist

The bot automatically handles message creation, reaction addition, and role assignment logic.

Real-Time Synchronization

Role assignments occur instantly:

• Adding a reaction assigns the role immediately
• Removing a reaction removes the role immediately
• No delays or manual intervention required

Organizational Tools

• Categories - Group related roles into logical sections
• Formatting - Rich text support with markdown
• Customization - Match your server's visual theme

Advanced Capabilities

• Auto-Moderation — Filter bad words, links, spam, mentions, invites, and caps lock with customizable actions
• Ticketing System — Support tickets with categories, transcripts, and staff analytics
• Giveaways — Weighted random draws with bonus entries, entry limits, and claim periods
• Temporary Roles — Auto-expiring roles with DM notifications
• Scheduled Roles — One-time and recurring role assignments
• Role Bundles — Reusable groups of roles for quick setup
• XP & Levels — Experience tracking with leaderboards and level rewards
• Welcome & Goodbye — Customizable messages with embed support and auto-roles
• Moderation — Timeout, warn, ban, kick with bulk operations and history tracking
• Voice Roles — Auto-control users in voice channels based on their roles
• Custom Commands — Create your own slash commands with buttons and menus (Pro Engine)
• Polls, 8ball, RPS, WYR — Interactive entertainment features

Management Features

• Update existing role messages
• Add or remove roles from messages
• Temporary roles with automatic expiration
• Bulk role management operations
• Comprehensive logging and monitoring
• Web dashboard for server configuration

Next Steps: Add the bot to your server and create your first role message.