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

# Setup

> Configure custom roles.

## Creating a Custom Role

```bash theme={null}
?rolesetup create <name> <role>
```

Example:

```bash theme={null}
?rolesetup create vip @VIP
```

After creation, the role can be managed using:

```txt theme={null}
?vip @User
```

Running the command again will remove the role from the member.

<Info>
  Custom role names cannot contain spaces and cannot start with numbers or special characters.
</Info>

***

## Adding Custom Role Managers

Custom Role Managers are allowed to use custom role commands.

```bash theme={null}
?rolesetup manager add <role>
```

Example:

```bash theme={null}
?rolesetup manager add @Event Managers
```

Members with this role will be able to grant and remove custom roles.

***

## Removing Manager Roles

```bash theme={null}
?rolesetup manager remove <role>
```

Removes a role from the Custom Role Manager list.

***

## Viewing Configuration

```bash theme={null}
?rolesetup config
```

Displays:

* All configured custom roles
* All custom role manager roles

***

## Viewing Custom Role Information

```bash theme={null}
?rolesetup info <customrole>
```

Displays information about a custom role, including:

* Role name
* Linked Discord role
* Creator
* Internal ID

***

## Deleting a Custom Role

```bash theme={null}
?rolesetup delete <customrole>
```

Removes a custom role command from the server.

The Discord role itself is not deleted.

***

## Resetting Custom Roles

```bash theme={null}
?rolesetup reset
```

Removes:

* All custom role commands
* All custom role manager roles

<Warning>
  This action cannot be undone.
</Warning>

## Permission Requirements

Users can manage custom roles if they:

* Have the Manage Server permission
* Own the server
* Have a configured Custom Role Manager role

The bot's highest role must remain above all custom roles that it needs to manage.