NoxBot NoxBot Docs

Roles

Let members pick up their own roles from a panel in a channel, using buttons or a dropdown. No reactions, works across bot restarts.


Role panels let your members give themselves roles, for example a “Giveaway ping” or “Event ping” role. You build a panel in the dashboard, post it into a channel, and members click to pick up or drop a role. NoxBot does this with buttons or a dropdown, never with reactions, so the panel keeps working after a restart.

Creating a panel

Open Roles in the dashboard and hit New panel. A live preview on the right shows exactly how the message will look while you fill it in.

  • Title and description - the headline and text of the panel message.
  • Channel - where the panel is posted.
  • Layout - choose Buttons (one button per role, great for a handful of ping roles) or Dropdown (a single menu, better when you have many roles).
  • Roles - add a row per role. Pick the role, set the button text and optionally an emoji. In the dropdown layout you can also add a short description per entry.
  • Colour - the accent colour of the message.

You can create as many panels as you like, for example one panel for ping roles and another for colour roles.

Posting and updating

Saving a panel keeps it as a draft. Use Post to channel to publish it. If you later edit a live panel it is re-posted automatically, so your changes show up without another step. Remove message takes the panel message down again but keeps the draft; Delete removes both.

Picking up roles

Members click a button (or pick from the dropdown) and NoxBot adds or removes the role right away, with a short private confirmation. With buttons, each click toggles one role. With the dropdown, the selection becomes the member’s set of this panel’s roles - picking new entries adds them, leaving entries out removes them. Roles that are not part of the panel are never touched.

The bot role must sit above the roles it hands out

NoxBot can only assign a role that is **below its own highest role**. In your server settings, drag the NoxBot role above every role you offer on a panel. Managed roles (like other bots' roles) can never be self-assigned.