> ## Documentation Index
> Fetch the complete documentation index at: https://vulture.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Role Management

> Create, edit, toggle, and mass-assign roles.

All role commands are grouped under `,role`. Requires **Manage Roles** (or a matching fake permission).

## Quick toggle (by ID)

Use IDs to avoid pinging members or roles.

| Command                        | Description                                          |
| ------------------------------ | ---------------------------------------------------- |
| `,role <user_id> <role_id>`    | Toggle a role — adds if missing, removes if present. |
| `,role add <member> <role>`    | Same toggle behavior with mentions or names.         |
| `,role remove <member> <role>` | Same toggle behavior.                                |

## Inrole

| Command             | Description                                        |
| ------------------- | -------------------------------------------------- |
| `,inrole <role_id>` | List every member in a role (shows IDs, no pings). |
| `,ir <role_id>`     | Short alias for inrole.                            |

## Role management

| Command                             | Description                                          |
| ----------------------------------- | ---------------------------------------------------- |
| `,role`                             | Show the full role command list.                     |
| `,role strip <member>`              | Remove every role from a member (saved for restore). |
| `,role restore <member>`            | Re-add stripped roles.                               |
| `,role humans <role>`               | Give a role to every human member.                   |
| `,role bots <role>`                 | Give a role to every bot.                            |
| `,role removeall <role>`            | Remove a role from every human.                      |
| `,role has <source> <target>`       | Give *target* to anyone who has *source*.            |
| `,role hasremove <source> <target>` | Remove *target* from anyone who has *source*.        |
| `,role create <name> [color]`       | Create a role. Color is a hex code.                  |
| `,role rename <old> <new>`          | Rename a role.                                       |
| `,role hoist <role>`                | Toggle separate display in the member list.          |
| `,role icon <role> <emoji>`         | Set a role display icon.                             |
| `,role delete <role>`               | Delete a role.                                       |

## Booster roles

Boosters can create a personal custom role. Requires **Manage Roles** for `base`.

| Command                | Description                                       |
| ---------------------- | ------------------------------------------------- |
| `,boosterrole` / `,br` | Show booster role commands.                       |
| `,br base <role>`      | Set the base role position for new booster roles. |
| `,br create [name]`    | Create your personal booster role.                |
| `,br color <hex>`      | Change your role color.                           |
| `,br icon <emoji>`     | Set your role icon.                               |
| `,br share <member>`   | Share your booster role with someone.             |

<Tip>
  When members leave, Luster remembers their roles for 2 hours so you can restore them if they rejoin.
</Tip>