# 🤖 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.

Auto Role Bot

Auto Role Bot automates role assignment on member join and when users tag your server. Set join roles, tag roles, and manage with commands.

Voting for Auto Role Bot

Do you want to support us?