reaction roles
reaction roles allow you to set up buttons where members can click to receive designated roles
setup
first, you must create a reaction role. to do this, you should use the command below. this will start a process asking you questions to generate the initial message, such as the title, description and channel. the title is not required, but the description and channel are.
this will act as a group that you can can add roles too, see adding roles
/reactionroles createadding roles
to add a role once you’ve created a reaction role using the command above, use the command below. the suggestions given by nypsi will assist you in choosing the correct options.
/reactionroles addrole <message id> <role> <label|emoji>removing roles
removing a role is very similar to adding a role.
/reactionroles removerole <message id> <role>changing modes
possible modes: many unique.
unique will ensure that the member only has one of the available roles, while many will allow them to have as many as they want
/reactionroles update <message id> mode <many|unique>with the update command you can also update other details:
- title
- description
- embed colour
updating the message
when you make a change to a reactionrole, you may notice that it doesn’t update the message. you
have to use /reactionroles send <message id> to resend the message.
this allows you to make changes without users seeing and being disturbed by every change
whitelist
the whitelist allows you to enforce users to have a certain role before they can use the reaction role. this is useful for only allowing certain roles to be given to certain users, such as in conjunction with a chat levelling bot.
a whitelist can have multiple roles. in this case, if a user has any of the roles in the whitelist, they will be allowed to use the reaction role.
you can view the current whitelist with /reaction roles whitelist list <message id>
adding a role to the whitelist
use the command below to add a role to the whitelist for a specific reaction role
/reactionroles whitelist add <message id> <role>removing a role from the whitelist
use the command below to add a role to the whitelist for a specific reaction role
/reactionroles whitelist remove <message id> <role>