Reaction Roles

Setup and configure reaction role panels and reactions

Configuration Options

General Settings

Option	Description	Example
Enabled	Set this to true to enable the reaction roles system.	true
useButtons	Set to true to use buttons instead of a select menu.	true
resetReacts	Set to true to remove the user's reaction after assigning the role.	true
ChannelID	The ID of the channel where the reaction role panel will be posted.	"CHANNEL_ID"

Hint: Use buttons for a more interactive and modern user experience.

Example Configuration

ReactionRoles:
  Enabled: false

  Panel1:
    useButtons: true
    resetReacts: true
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "Welcome to the Role Selection Panel"
      Description:
        - "React with the emojis below to receive the corresponding roles:"
        - "> 🟦 for the Blue Role"
        - "> 🟥 for the Red Role"
      Footer:
        Text: "Drako Development | Reaction Role System"
        Icon: "https://i.imgur.com/w5XxKpc.png"
      Author:
        Text: "Reaction Panel"
        Icon: "https://i.imgur.com/w5XxKpc.png"
      Color: "#0099ff"
    Reactions:
      - Name: "Blue Role"
        Emoji: "🟦"
        Style: "Primary"
        Description: "Get the Blue Role"
        RoleID: "ROLE_ID"
      - Name: "Red Role"
        Emoji: "🟥"
        Style: "Danger"
        Description: "Get the Red Role"
        RoleID: "ROLE_ID"

  # Support multiple panels (Copy and paste Panel1 and change it to Panel2)

Configuration Details

Embed Settings

Option	Description	Example
Title	The title of the embed panel.	"Welcome to the Role Selection Panel"
Description	The description of the embed panel. Use lists to make it clear.	See example above
Footer	The footer text and icon for the embed.	`"Drako Development
Author	The author text and icon for the embed.	"Reaction Panel"
Color	The color of the embed. Use hex codes for custom colors.	"#0099ff"

Reaction Settings

Option	Description	Example
Name	The name of the role to be assigned.	"Blue Role"
Emoji	The emoji used for the reaction.	"🟦"
Style	The style of the button (Primary, Secondary, Success, Danger).	"Primary"
Description	A brief description of the role.	"Get the Blue Role"
RoleID	The ID of the role to be assigned.	"ROLE_ID"

Hint: Ensure that the RoleID corresponds to roles that exist in your Discord server.

Adding Multiple Panels

To support multiple panels, copy the configuration for Panel1 and rename it to Panel2, Panel3, etc., adjusting the details as needed.

Example for Multiple Panels

ReactionRoles:
  Enabled: true

  Panel1:
    useButtons: true
    resetReacts: true
    ChannelID: "CHANNEL_ID_1"
    Embed:
      Title: "Welcome to the Role Selection Panel"
      Description:
        - "React with the emojis below to receive the corresponding roles:"
        - "> 🟦 for the Blue Role"
        - "> 🟥 for the Red Role"
      Footer:
        Text: "Drako Development | Reaction Role System"
        Icon: "https://i.imgur.com/w5XxKpc.png"
      Author:
        Text: "Reaction Panel"
        Icon: "https://i.imgur.com/w5XxKpc.png"
      Color: "#0099ff"
    Reactions:
      - Name: "Blue Role"
        Emoji: "🟦"
        Style: "Primary"
        Description: "Get the Blue Role"
        RoleID: "ROLE_ID"
      - Name: "Red Role"
        Emoji: "🟥"
        Style: "Danger"
        Description: "Get the Red Role"
        RoleID: "ROLE_ID"

  Panel2:
    useButtons: true
    resetReacts: true
    ChannelID: "CHANNEL_ID_2"
    Embed:
      Title: "Gaming Role Selection"
      Description:
        - "React with the emojis below to receive the corresponding roles:"
        - "> 🎮 for the Gamer Role"
        - "> 🖥️ for the Tech Role"
      Footer:
        Text: "Drako Development | Reaction Role System"
        Icon: "https://i.imgur.com/w5XxKpc.png"
      Author:
        Text: "Gaming Panel"
        Icon: "https://i.imgur.com/w5XxKpc.png"
      Color: "#00ff00"
    Reactions:
      - Name: "Gamer Role"
        Emoji: "🎮"
        Style: "Primary"
        Description: "Get the Gamer Role"
        RoleID: "ROLE_ID_GAMER"
      - Name: "Tech Role"
        Emoji: "🖥️"
        Style: "Secondary"
        Description: "Get the Tech Role"
        RoleID: "ROLE_ID_TECH"

Hint: Use different channel IDs and customize the embed details for each panel to match the specific roles and themes.