Documentation

Color Role Panels

Manage color roles with embed-based panels (5 roles per message) and simple chat commands. This page is public and does not require login.

Deploy the panel

  1. Go to the channel where you want the color role panel.
  2. Run !setroles.
  3. The bot posts embeds with 5 roles per message and adds the reaction emojis.

Running !setroles clears the channel and rebuilds the role prompts.

Manage colors

  • !cr add <name> <color> creates a new role and refreshes the panel.
  • !cr remove <@role|roleId> removes a color role (and deletes it if possible).
  • !cr list prints the current color role list.

You need Manage Roles or Manage Server to use !cr.

Command reference

!cr add <name> <color>

Create a new color role and add it to the embed panel. The color token must be last.

!cr add Sunset #ff7a00
!cr add Sky rgb(116,185,255)
!cr add Lavender rgba(162,155,254,0.8)

You can also add multiple colors in one message:

!cr add Rose Quartz #f78fb3
Sky Blue #74b9ff
Lemon Zest #fff06a
  • Hex formats: #RRGGBB or #RGB.
  • RGB formats: rgb(255, 136, 0) or rgba(255, 136, 0, 0.5) (alpha is ignored).
  • The bot auto-assigns an emoji for the new role.

!cr remove <@role|roleId>

Remove a color role from the panel by mentioning the role (or providing its ID).

!cr remove @Color: Sunset
!cr remove 123456789012345678

!cr list

Show all configured color roles with their emojis.

!cr list

Behavior details

  • The panel posts as embeds with 5 roles per message; multiple messages are sent automatically.
  • Reactions are the only way to claim colors: add a reaction to gain the role, remove it to drop the role.
  • When you add or remove colors, the panel auto-refreshes if a color role channel is already configured.