Reaction Roles
Add or remove roles when a user adds a reaction to a message
Last updated
Add or remove roles when a user adds a reaction to a message
Last updated
The Reaction Role module allows you to configure messages that allow users to assign and remove roles by reacting to a message.
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.
If the bot is not adding the first reaction to the message, try the following steps:
Make sure the Remove Reaction setting is disabled.
If this didn't solve the issue, add the reaction to the message yourself.
If you're still experiencing issues, join our support server to ask for further help.
If the bot is not recognizing an emoji and not adding the role, try the following steps:
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.
If you're still experiencing issues, join our support server to ask for further help.
If the module is not doing anything, try the following steps:
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.
Reset your bot's token on the Discord Developer Portal. Paste your token into your bot's settings and start the bot.
If you're still experiencing issues, join our support server to ask for further help.
The Reaction Role module has different configurations which change how roles are given or removed.
Here you will need to enter the message ID of the message you wish to use as the reaction roles panel.
Here you can enter the emoji that is used on the reaction message, this can be discord emojis or custom emojis.
Here you can select the roles to add to the user when they react to the message.
Here you can select some roles the bot should remove when the user reacts to the message.
Here you can enable/disable the option to restrict a user's reaction to one reaction at a time.
Here you can enable/disable the option for the bot to remove the user's reaction once they have been given the role.
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.
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.
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.
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.
