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

Enabling Reaction Roles

This module must be enabled in order to be used. Click the Enabled button in the top right hand side of the module page.

Reaction Role Configurations

The Reaction Role module has different configurations which change how roles are given or removed.
Configuration
Details
Permanent
A member can only claim one role from the message ever. Unreacting will not remove the role. Reacting to other roles will do nothing.
Unique
A member can only have one role from the message at a time. Unreacting will remove the role. Reacting to other roles will give a new role, and remove the old.
Multi
A member can have multiple roles at a time. Unreacting will remove the role. Reacting to other roles will give a new role, and will not remove other roles.
Reversed
Reacting will remove a role. Unreacting will add a role. Members can have multiple roles.

Creating a Reaction Role Message

To create a Reaction Role Message click on either Existing Message or New Message.

Existing Message

This option allows you to set up Reaction Roles on an existing message in your guild. This is best used if you wish for the message to be plain text or have an existing embed message. To create a Reaction Role using an existing message:
  1. 1.
    Select the Guild you wish to configure for from the drop-down menu.
  2. 2.
    Select the text channel that the existing message is in.
  3. 3.
    Get the ID of the message. You can find out how to get a message's ID by following this guide.
  4. 4.
    Select the Reaction Role configuration type. You can see an explanation of each type above.
  5. 5.
    Add Reaction Roles
    1. 1.
      Copy and paste an emoji, using the emoji Button on the Top Right of the Module Builder.
    2. 2.
      Select the role from the dropdown menu.
  6. 6.
    Click Add and then save the command.
Reminder:
If you cannot find your server or Role you're looking for, refresh the Guild data.

New Message

This option allows you to set up Reaction Roles on a new Rich Embed message. To create a Reaction Role using a new message:
  1. 1.
    Select the Guild you wish to configure for from the drop-down menu.
  2. 2.
    Select the text channel to post the new message in.
  3. 3.
    Fill out the fields for the new Embed message. Only the title and body are required.
  4. 4.
    Select the Reaction Role configuration type. You can see an explanation of each type above.
  5. 5.
    Add Reaction Roles
    1. 1.
      Copy and paste an emoji from here: https://getemoji.com/​
    2. 2.
      Select the role from the dropdown menu
    3. 3.
      Click Add
  6. 6.
    Click Save