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 setup 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. Select the Guild you wish to configure for from the drop-down menu.

  2. Select the text channel that the existing message is in.

  3. Get the ID of the message. You can find out how to get a message's ID by following this guide https://www.youtube.com/watch?v=uq4LJDbIIj0

  4. Select the Reaction Role configuration type. You can see an explanation of each type above.

  5. Add Reaction Roles

    1. Copy paste an emoji from here: https://getemoji.com/

    2. Select the role from the dropdown

    3. Click Add

  6. Click Save

New Message

This option allows you to setup Reaction Roles on a new RichEmbed message. To create a Reaction Role using a new message:

  1. Select the Guild you wish to configure for from the drop-down menu.

  2. Select the text channel to post the new message in.

  3. Fill out the fields for the new Embed message. Only the title and body are required.

  4. Select the Reaction Role configuration type. You can see an explanation of each type above.

  5. Add Reaction Roles

    1. Copy paste an emoji from here: https://getemoji.com/

    2. Select the role from the dropdown

    3. Click Add

  6. Click Save