reaction-roles
Last updated
Last updated
This command allows you to set up reaction roles in your server. Reaction roles allow users to assign/remove roles to/from themselves by reacting to specific messages that server admins set up. There are several customization options to optimize your needs.
This is only the technical documentation of the command and not intended to be a tutorial on how to set up reaction roles. For a tutorial on how to set them up, refer to the respective .
MoonlightBot requires the following permissions to successfully execute this command:
Manage Roles
By default, a user is required to have the following permissions to use this command:
Manage Server
For more information on editing permission requirements for specific users/roles, refer to the
This command allows you to pair a role with an emoji in a group, if the group is not set up, it will be created. You can use the same command to unpair the role from the emoji. Also, you can pair multiple roles to the same emoji, and they will be given to the user at the same time.
group: The name of the group to add the pair to
emoji: The emoji to be used
role: The role to be assigned
MoonlightBot requires the following permissions to successfully execute this subcommand:
No specific permissions required
This command allows you to view all the groups of reaction roles that have been set up.
This subcommand does not have any options.
MoonlightBot requires the following permissions to successfully execute this subcommand:
No specific permissions required
group: The name of the group to view information about
MoonlightBot requires the following permissions to successfully execute this subcommand:
No specific permissions required
This command allows you to delete a group of reaction roles.
group: The name of the group to be deleted
MoonlightBot requires the following permissions to successfully execute this subcommand:
No specific permissions required
This command automatically "repairs" errors in a group. With "repair" is meant that it will remove the IDs of roles that do not exist anymore from the pairings.
The disconnect-messages option is a dangerous option to use and only should be used if you know what you are doing. It is a disruptive operation and will make reaction roles on messages to which this group was applied non-functional. They need to be reapplied appropriately afterwards to work again.
If you only want to remove a group from a message, right-click the message and select "Remove reaction roles" instead.
group: The name of the group to be repaired
disconnect-messages: Removes the group form all messages applied to (True/False)
MoonlightBot requires the following permissions to successfully execute this subcommand:
No specific permissions required
This command does not trigger any log events.
This command allows you to view information about a group of reaction roles. It will list all options that can be set via the command.
For more information on setting up those logs, refer to the