🤖 Auto Role Bot — Complete Role Automation & Management for Discord

Auto Role Bot is a comprehensive Discord role management solution designed to automate role assignments, streamline server management, and enhance user engagement. Perfect for communities, gaming servers, study groups, and organizations of all sizes.

---

⚡ Core Features

🎯 Automatic Role Assignment

• Join Roles: Instantly assign up to 7 roles to new members upon joining
• Tag Roles: Automatically reward users who set your server as their primary Discord tag
• Connected Roles: Chain role assignments - automatically give roles based on existing roles (up to 5 setups)
• Reaction Roles: Interactive role assignment through emoji reactions on messages

⏰ Advanced Role Management

• Temporary Roles: Assign time-limited roles with flexible durations (minutes to months)
• Individual Role Control: Separate add/remove role buttons for specific members
• Bulk Role Management: Comprehensive bulk operations for bots, humans, or all members
  • Add or remove roles to multiple members at once
  • Advanced filtering with whitelist/blacklist role support
  • Smart targeting (only affects members who need the role change)
  • Rate-limited processing (2-second delay between assignments)
• Smart Cleanup: Automatically removes deleted roles from configurations

---

🎮 Command Overview

/autoroles - AutoRole Management Hub

Interactive dashboard for managing automatic role assignments:

• ➕ Add Join Role - Set roles for new member auto-assignment
• ➖ Remove Join Role - Remove roles from auto-assign list
• ⚙️ Manage Settings - View, list, or clear configurations
• 🏷️ Set Tag Role - Configure roles for server tag adopters
• 🔗 Connected Roles - Set up role chains and dependencies

/role - Manual Role Management

Comprehensive role management tools organized into two sections:

👥 Individual Role Management

• ⏰ Temporary Role - Assign roles with expiration (format: 1M 3d 1h 8m)
• ➕ Add Role - Add a role to a specific member
• ➖ Remove Role - Remove a role from a specific member

🔄 Bulk Role Management

• 🤖 All Bots - Bulk role operations for all bot accounts
• 👥 All Humans - Bulk role operations for all human users
• 🌐 All Members - Bulk role operations for all server members

Each bulk operation includes:

• Mode Selection: Add or Remove roles
• Target Role: Single role to assign/remove
• Whitelist Roles (Optional): Only affect members with ANY of these roles
• Blacklist Roles (Optional): Skip members with ANY of these roles
• Smart Filtering: Only processes members who need the role change

/reactionroles - Interactive Role Assignment

Set up emoji-based role assignment:

• ➕ Add Reaction Role - Create new reaction role setups
• ➖ Remove Reaction Role - Delete existing reaction roles
• ⚙️ Manage Settings - View or clear all reaction role configurations

Message Commands

• Setup Reaction Role - Right-click any message → Apps → Setup Reaction Role

/help - Interactive Help System

Comprehensive help with detailed explanations for all features and commands.

---

🚀 Advanced Capabilities

Real-Time Monitoring

• Uses Discord's raw gateway events for instant tag change detection
• Automatic temporary role expiration checking every 5 minutes
• Live reaction role processing with full emoji support (including custom server emojis)
• Rate-limited bulk role processing to prevent API throttling

Smart Configuration Management

• Persistent JSON-based storage with automatic backups
• Automatic cleanup of invalid/deleted roles
• Thread-safe configuration updates with asyncio locks
• Concurrent operation prevention for bulk role assignments

Multi-Shard Support

• Built for large servers with automatic sharding
• Real-time latency monitoring and status updates
• Scalable architecture supporting multiple guilds

Comprehensive Error Handling

• Graceful fallback for permission issues
• Detailed error logging for troubleshooting
• User-friendly error messages with solution suggestions

---

🔧 Setup & Configuration

1. Invite the bot with Administrator permissions
2. Use /autoroles to set up automatic role assignments
3. Configure /reactionroles for interactive role selection
4. Set temporary roles with /role for time-sensitive access
5. Use /help for detailed guidance on any feature

All commands use modern Discord UI components with interactive buttons, dropdowns, and modals for the smoothest user experience.

---

📞 Support

Need help or have questions? Join our support server for assistance, feature requests, and community discussion.

Start automating your server roles today - reduce manual work, improve member experience, and build a more organized Discord community.