Reaction Roles - Akatsuki2555/Akabot GitHub Wiki

Akabot Documentation: Reaction Roles Module

This module allows users to assign or remove roles by reacting to messages containing specific buttons. It provides commands to create different types of reaction role setups, such as normal, add-only, remove-only, and single-choice reaction roles.

Commands

/create_reaction_role normal

  • Description: Create a normal reaction role setup where users can add and remove roles by reacting to buttons.
  • Required Permissions: manage_roles
  • Usage: /create_reaction_role normal message role [role_2] [role_3] [role_4] [role_5]
    • message: The message content to send along with the reaction buttons.
    • role: Mention or ID of the role users can react to add or remove.
    • [role_2], [role_3], [role_4], [role_5]: Additional roles users can react to add or remove (optional).

/create_reaction_role add_only

  • Description: Create an add-only reaction role setup where users can only add roles by reacting to buttons.
  • Required Permissions: manage_roles
  • Usage: /create_reaction_role add_only message role [role_2] [role_3] [role_4] [role_5]
    • message: The message content to send along with the reaction buttons.
    • role: Mention or ID of the role users can react to add.
    • [role_2], [role_3], [role_4], [role_5]: Additional roles users can react to add (optional).

/create_reaction_role remove_only

  • Description: Create a remove-only reaction role setup where users can only remove roles by reacting to buttons.
  • Required Permissions: manage_roles
  • Usage: /create_reaction_role remove_only message role [role_2] [role_3] [role_4] [role_5]
    • message: The message content to send along with the reaction buttons.
    • role: Mention or ID of the role users can react to remove.
    • [role_2], [role_3], [role_4], [role_5]: Additional roles users can react to remove (optional).

/create_reaction_role single

  • Description: Create a single-choice reaction role setup where users can only select one role at a time by reacting to buttons.
  • Required Permissions: manage_roles
  • Usage: /create_reaction_role single message role [role_2] [role_3] [role_4] [role_5]
    • message: The message content to send along with the reaction buttons.
    • role: Mention or ID of the role users can select.
    • [role_2], [role_3], [role_4], [role_5]: Additional roles users can select (optional).

Functionality

This module simplifies the process of assigning and managing roles for users in a Discord server by utilizing reaction buttons on messages. Users can easily interact with these buttons to gain or lose specific roles based on the server's configuration.