YAGPDB Mutually Exclusive Roles and Reaction Roles Setup 2026
YAGPDB (Yet Another General Purpose Discord Bot) has a role menu system that lets users self-assign roles through reactions or buttons. Set role groups to mutually exclusive so users pick only one from a category.
What Are Mutually Exclusive Roles?
Mutually exclusive roles mean a user picks one role from a group and YAGPDB automatically removes any other role from that same group. Common uses:
- Color roles (pick one color, the previous one gets removed)
- Region roles (EU, NA, Asia: pick one)
- Notification tiers (Daily, Weekly, None)
Setup Steps
Step 1: Invite YAGPDB
Go to yagpdb.xyz and click "Add to Server." Open the control panel at yagpdb.xyz/manage.
Step 2: Create roles in Discord
Server Settings > Roles. Create the roles you want users to pick from. Make sure YAGPDB's role is positioned above them in the hierarchy.
Step 3: Configure role groups
In the YAGPDB control panel:
- Go to Role Commands in the sidebar
- Click Create Role Group
- Name it (example: "Color Roles")
- Set Mode to Single for mutually exclusive
- Add each role to the group
The Single mode is what enforces mutual exclusivity. When a user picks "Blue", YAGPDB removes "Red" or "Green" if they had one.
Mode options:
- Single: One role at a time (mutually exclusive)
- Multiple: Users pick as many as they want
- None: Disables the group
Step 4: Create a role menu message
Type -rolemenu create (group-name) in the target channel. YAGPDB posts a message with reactions for each role.
For a custom design: create an embed with -customembed, then run -rolemenu create (group-name) -m (message-id).
Step 5: Test
React with a second account. Verify the role is assigned, and that picking a different option removes the first role.
Troubleshooting
Bot does not assign roles:
- Check YAGPDB's role is above target roles in the role hierarchy
- Verify the bot has "Manage Roles" permission
- Confirm the role group mode is set to "Single" or "Multiple"
Roles not mutually exclusive:
- Confirm the mode is set to "Single" in the role group settings
- All exclusive roles must be in the same group
Hosting a Custom Bot 24/7
YAGPDB is hosted externally. For a fully custom bot with similar features and complete control, host on a VPS. Space-Node VPS plans start at 3.50 EUR/month with SSD storage and 99.9% uptime.
