Make members pick only one role with exclusive reaction roles

Before you start

• Use an online Build Discord Bots bot with Reaction Roles enabled in the server. A staff member changing panel settings needs Manage Roles, and the bot needs Manage Roles with its highest role above each role it will assign or remove.
• Give the bot View Channel, Send Messages, Embed Links, Read Message History and Add Reactions for its panels. Exclusive panels also need Manage Messages so the bot can remove a member’s old panel reactions. Enable the requested Server Members Intent and Message Content Intent in the Discord Developer Portal.

1. Set the default for new panels

   Open Reaction Roles in your bot’s Modules settings, select the server, and turn on Members Can Pick Only One (New Panels). Save the setting, then run !reactionrole to create and publish a panel with its emoji-role pairs. This dashboard toggle is only the default for newly published panels; it does not change a panel that already exists.

2. Change one published panel with rrmode

   For an existing panel, a member with Manage Roles can run !rrmode <messageId> on or !rrmode <messageId> off in that server. Use the ID of the published reaction-role message. on makes only that panel single-choice; off keeps its mapped roles independent. The setting is stored on that panel, not as a retroactive server-wide change.

3. Test the role swap and reaction cleanup

   In a safe test panel, react to one mapped emoji and then another. With exclusive mode on, the new panel role is assigned and earlier mapped panel roles are removed. The bot also attempts to remove earlier panel reactions, which requires its Manage Messages permission; if Discord denies that permission, staff should repair it before relying on reaction cleanup. Removing the currently selected reaction still follows the panel’s Allow Role Removal On Reaction Remove setting.