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.

Common Issues

Experiencing issues with the module? Check out the common issues below. If your issue is not listed in this page, make sure your module is updated to the latest version. If you are still experiencing issues with the module, join our support server to ask for further help.

The bot is not reacting to the message

If the bot is not adding the first reaction to the message, try the following steps:

1

Make sure the Remove Reaction setting is disabled.

2

If this didn't solve the issue, add the reaction to the message yourself.

3

If you're still experiencing issues, join our support server to ask for further help.

The bot doesn't recognize an emoji

If the bot is not recognizing an emoji and not adding the role, try the following steps:

1

Make sure you added the right unicode character for default emojis, like this: 1️⃣, or the right name for custom emojis. For instance, if your custom emoji is called <:BotGhostWave:1048697598355189850>, only add BotGhostWave.

2

If you're still experiencing issues, join our support server to ask for further help.

The module is not working at all

If the module is not doing anything, try the following steps:

1

Check if your bot is on BotPanel. If it is, enable the module there too and set it up from BotPanel, or remove the bot from BotPanel if you're not intending to use it.

2

Reset your bot's token on the Discord Developer Portal. Paste your token into your bot's settings and start the bot.

3

If you're still experiencing issues, join our support server to ask for further help.

---

Watch the Tutorial

---

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.