Reaction Roles

The Reaction Roles system lets members self-assign roles through interactive panels.

Basic Button Panel Example

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 IDs.

---

Quick Setup Examples

1️⃣ Basic Server Roles (Button Panel)

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"
        Style: "Success"
        RoleID: "ROLE_ID"
        Description: "Event Pings"

---

2️⃣ Pronoun Roles (Select Menu Panel)

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"

---

3️⃣ Age/Region Verification (Reaction Panel)

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"

---

How to post the panel

• To post a panel you will need to restart the bot.

• Once restarted the panel will appear in the channel.

---

Troubleshooting

❌ Buttons/Reactions not working

• Ensure ReactionRoles.Enabled = true

• Bot needs Manage Roles permission

• Bot’s role must be above roles being assigned

❌ Panel not appearing

• Channel ID is incorrect

• Bot hasn't been restarted

❌ Roles not assigned

• Replace all ROLE_IDs with actual IDs

• Ensure that the bots role is higher than the assigned role

❌ Multiple panels interfering

• Each panel needs a unique name