Skip to main content
The Reaction Role system allows you to create interactive panels where server members can click on emojis beneath a message to automatically receive or remove roles. ZEON’s reaction role engine supports multiple assignment modes (like unique selections or reverse roles) and allows up to 20 reaction roles per message.
Required Permission: Server Owner, Extra Owners, and Admin Access can manage reaction roles.

​
Basic Setup

​
1. Add a Reaction Role

To add a single reaction role to a message, use the add command. You can provide either the Message ID or the direct Message Link.

​
2. Add Multiple Reaction Roles (Bulk)

If you want to set up an entire panel at once, use addmany. You must provide exact pairs of emojis and role mentions (or Role IDs).
When using custom emojis, make sure ZEON is in the server where the emoji originates, or it won’t be able to react to the message!

​
Panel Modes (Format)

You can change how a reaction role panel behaves using the format command. This allows you to create distinct types of role panels, like color selectors or verification buttons.

​
Maximum Roles Limit

If you want to allow users to pick multiple roles but still restrict them to a specific amount (e.g., “Pick up to 3 game roles”), use the maxroles command:
(Set <count> to 0 to allow unlimited roles).

​
Management Commands

Once a panel is set up, you can edit, clone, or completely wipe it using the following commands:

​
Security Restrictions

To protect your server from privilege escalation attacks, ZEON enforces strict security checks when creating reaction roles:
  1. Hierarchy Guard: You cannot assign a role that is higher than or equal to your own top role (unless you are the Server Owner).
  2. Bot Hierarchy: The bot cannot assign roles that are higher than its own top role.
  3. Dangerous Permissions Guard: ZEON will explicitly block any attempt to create a reaction role for a role that contains dangerous permissions (e.g., Administrator, Manage Server, Ban Members). This ensures no one can accidentally create a backdoor into your server.