Categories

Create a Role Category

Adding categories can be done with a simple command:

/category create

Configure a Role Category

/category config

type: Type that will determine the behavior of the category.
component: Allows you to set a category component to use buttons or private select menu instead of the default select menu.
placeholder: Placeholder text of select menu component.
max-options: Maximum number of selectable options / roles in the select menu / role-button row.
min-options: Minimum number of selectable options / roles in the select menu / role-button row.
secret-code: Custom code that users have to submit to access the category.

Set secret-code to Random to generate a random 8-digit code.

Set to DynamicRandom to generate a random 8-digit code, that will be updated after each successful submit. You can give these codes as one-time "keys" for access.

Set to Verification to require 8-digit captcha from a member.

To change the number of digits, add a number from 1 to 35 after each type, for example: Random10, DynamicRandom5, Verification3.

Category Types

Toggle: Users will be allowed to select / deselect roles from this category.

Set / Toggle: Users will be allowed to select / deselect roles from this category. Set, if the category component is Select Menu. Removes all roles and gives the selected ones. Toggle, if the category component is Private Select Menu or Buttons.

Only Get: Roles from this category can be added, but not removed.

Unique Get: Users will only be allowed to select a single role from this category. Roles can be removed. Value max-options equals 1 and cannot be changed.

Only Remove: Roles in this category will only be able to be removed, not added.

Category Components

Buttons

Supports up to 25 role options. Label, emoji, and color of each button can be changed.

Supports up to 25 role options. Label, emoji, and description of each option can be changed.

Supports up to 100 role options with role paginating. Also includes a button to clear all roles of this category. Just like in the default select menu - label, emoji, and description of each option can be changed.

You can delete some of the category parameters using - as a value.

Edit Category's Embed

You can edit the embed of the category's message using this command:

/category edit-embed

If you need to see a list of the categories, you can do that with:

/category list

Removing a Category

You can remove a category, but doing so will remove all configured roles in this category as well. Roles will stay in your server, but you will need to reassign them to a category.

/category delete

Reorder or Sort Roles in a Category

You can't reorder a category with more than 25 roles.

/category-advanced rearrange

Synchronizing a Category

Since the bot can temporarily disconnect from Discord, role deletions and name changes may not be recognized. If you delete a role or update a role's name, you can update components for that category by using this subcommand: