Reaction Roles

Add or remove roles when a user adds a reaction to a message

The Reaction Role module allows you to configure messages that allow users to assign and remove roles by reacting to a message.

Settings

Setup

The Reaction Role module has different configurations which change how roles are given or removed.

Message ID

Here you will need to enter the message ID of the message you wish to use as the reaction roles panel.

Reaction Emoji

Here you can enter the emoji that is used on the reaction message, this can be discord emojis or custom emojis.

Roles To Add

Here you can select the roles to add to the user when they react to the message.

Roles To Remove

Here you can select some roles the bot should remove when the user reacts to the message.

Restrict To One Reaction

Here you can enable/disable the option to restrict a user's reaction to one reaction at a time.

Remove Reaction

Here you can enable/disable the option for the bot to remove the user's reaction once they have been given the role.

Blacklisted Roles

Here you can select some roles that are unable to use this reaction message. Users with this role will not be able to react to the message as the bot will instantly delete it.

To save the reaction roles settings, you need to click "Add" in the bottom-right corner of the settings. This will reset the fields so you can set up another reaction role.

Active Reaction Roles

Once you have added a reaction role from the settings above, a new area will appear that contains all the active reaction roles. You may edit / delete any of these active reaction roles on the bottom right of the image below.

To save the edits you made on the reaction role settings, you need to click "Edit" in the bottom-right corner of the settings.

---

Events

In this area, you can view and modify the events of the Reaction Roles module. Below you may find some information on each event of the module.

Reaction Roles #...

Once you add a Reaction Role, the corresponding event will be created. This will handle the newly created Reaction Role.

---

It's advised that you do not edit the events unless you have a good understanding of BotGhost and its Event Builder. If you encounter any issues, you might want to reset the module for it to work again as intented.

Additionally, a copy of the edited commands / events will be created if you update the module.