Reaction Roles

Basic Button Panel Example

reaction_roles.yml

ReactionRoles:
  Enabled: true

  ServerRoles:
    type: "BUTTON"
    resetReacts: true
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "**Choose Your Roles!**"
      Description:
        - "Click a button below to get or remove a role."
      Color: "#1769FF"
    Reactions:
      - Name: "Announcements"
        Emoji: "📢"
        Style: "Primary"
        RoleID: "ROLE_ID"
        Description: "Announcement Pings"
      - Name: "Events"
        Emoji: "🎉"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "Event Pings"

Replace CHANNEL_ID with the channel you want the panel in. Replace each ROLE_ID with real role IDs.

---

Quick Setup Examples

1

Basic Server Roles (Button Panel)

basic_server_roles.yml

ReactionRoles:
  Enabled: true

  ServerRoles:
    type: "BUTTON"
    resetReacts: true
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "📢 Server Roles"
      Description:
        - "Choose which notifications you’d like."
      Color: "#1769FF"
    Reactions:
      - Name: "Announcements"
        Emoji: "📢"
        Style: "Primary"
        RoleID: "ROLE_ID"
        Description: "Announcement Pings"
      - Name: "Events"
        Emoji: "🎉"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "Event Pings"

Replace CHANNEL_ID and ROLE_ID placeholders with actual IDs.

2

Pronoun Roles (Select Menu Panel)

pronoun_roles.yml

ReactionRoles:
  Enabled: true

  Pronouns:
    type: "SELECT"
    resetReacts: false
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "🌈 Pronoun Roles"
      Description:
        - "Pick the pronouns that fit you."
      Color: "#FFA500"
    Reactions:
      - Name: "He/Him"
        Emoji: "👨"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "He/Him"
      - Name: "She/Her"
        Emoji: "👩"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "She/Her"
      - Name: "They/Them"
        Emoji: "⚧️"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "They/Them"

Replace CHANNEL_ID and ROLE_ID placeholders with actual IDs.

3

Age/Region Verification (Reaction Panel)

verification_panel.yml

ReactionRoles:
  Enabled: true

  Verification:
    type: "REACT"
    resetReacts: true
    ChannelID: "CHANNEL_ID"
    Embed:
      Title: "✅ Verification"
      Description:
        - "React below to verify and unlock the server."
      Color: "#00FF00"
    Reactions:
      - Name: "18+"
        Emoji: "🔞"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "18+ Age"
      - Name: "Under 18"
        Emoji: "🍼"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "Under 18"
      - Name: "North America"
        Emoji: "🌎"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "NA"
      - Name: "Europe"
        Emoji: "🌍"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "EU"
      - Name: "Asia"
        Emoji: "🌏"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "Asia"

Replace CHANNEL_ID and ROLE_ID placeholders with actual IDs.

---

How to post the panel

• Restart the bot to apply the configuration.

• After restart, the panel will appear in the configured channel.

---

Troubleshooting

Buttons/Reactions not working

• Ensure ReactionRoles.Enabled = true

• Bot needs the Manage Roles permission

• Bot’s role must be above the roles being assigned

Panel not appearing

• Channel ID is incorrect

• Bot hasn't been restarted

Roles not assigned

• Replace all ROLE_ID placeholders with actual IDs

• Ensure that the bot's role is higher than the assigned role

Multiple panels interfering

• Each panel needs a unique name