> For the complete documentation index, see [llms.txt](https://levelrdocs.xmo.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://levelrdocs.xmo.dev/commands/admin/config.md).

# /config

Subcommands for the /config command. This command is restricted to the Administrator permission by default.

{% tabs %}
{% tab title="rankcolor" %}

```
/config rankcolor [choice] [color]
```

{% hint style="info" %}

## Arguments

\[choice] - Choose which color to modify, either the `Background Color` or `Text Color`

\[color] - The new color for the selected attribute. Can be a hex code (`#a564ee`) or named color (`blue`).
{% endhint %}

This command allows you to change the background and text/highlight color of **the server's default rank card**. These colors are lower in hierarchy than user-specific colors.
{% endtab %}

{% tab title="channelblacklist" %}

```
/config channelblacklist
```

{% hint style="info" %}
*This command has no arguments.*
{% endhint %}

This command brings up an interactive menu which shows and allows you to add/remove channels to/from a list. You **cannot** earn XP sending messages in the channels added to this list.
{% endtab %}

{% tab title="voiceleveling" %}

```
/config voiceleveling [toggle]
```

{% hint style="info" %}

## Arguments

\[toggle] - Choose the server-wide toggle for Voice Leveling, either `Enabled` or `Disabled`
{% endhint %}

This command allows you to toggle on or off Voice Leveling for the entire server. By default, voice leveling is Disabled preventing any XP earn in voice channels. You can enable this to allow that. When voice leveling is enabled, you can still blacklist channels from earning XP and set custom XP values for your voice channels, and they will be respected.
{% endtab %}

{% tab title="roleblacklist" %}

```
/config roleblacklist
```

{% hint style="info" %}
*This command has no arguments.*
{% endhint %}

This command brings up an interactive menu which shows and allows you to add/remove roles to/from a list. You **cannot** earn XP sending messages if you have any of the roles on this list.
{% endtab %}

{% tab title="rolestack" %}

```
/config rolestack [toggle]
```

{% hint style="info" %}

## Arguments

\[toggle] - A boolean denoting whether to stack level roles or not.
{% endhint %}

This command allows you to toggle role stacking. If role stacking is enabled, level roles will be stacked when users reach new level role milestones. If it is disabled, only the highest level role will be retained.
{% endtab %}

{% tab title="xprate" %}

```
/config xprate <rate>
```

{% hint style="info" %}

## Arguments

\<rate> - The rate to set the XP to. Select one of the options that appears. If this argument is not provided, Levelr will return the current XP rate.
{% endhint %}

This command allows you to view and modify the XP rate of the server. By default (`1x` XP rate), every minute that you're messaging, you randomly gain between 15 and 25 XP. You can edit the XP rate from `0.25x` to `5x`.
{% endtab %}

{% tab title="levelmessage" %}

```
/config levelmessage
```

{% hint style="info" %}
*This command has no arguments.*
{% endhint %}

This command returns a modal which allows you to enable or disable level up messages, as well as edit the message that is sent.&#x20;

In the `Enable/Disable Level up Messages` box, you must use `Y` to enable, or `N` to disable.&#x20;

In the `Level up Message` box, you can use the `{user}` placeholder to mention the user that is leveling up, and the `{level}` placeholder to denote the level that they have reached. This field is limited to 1,000 characters.
{% endtab %}

{% tab title="levelroles" %}

```
/config levelroles add [level] [role]
/config levelroles remove [role]
/config levelroles view
```

{% hint style="info" %}

## Arguments

\[level] - The level to assign the given role at. Must be an integer between 1 and 500.

\[role] - The role to bind with a level or be removed from the list.
{% endhint %}

This command allows you to add, remove, or view the level and role bindings list. This list denotes what roles will be given to a user upon hitting the specified level.
{% endtab %}

{% tab title="activeroles" %}

```
/config activeroles add [role] [frequency] [consecutive] <exclusions>
/config activeroles remove [role]
/config activeroles view
```

{% hint style="info" %}

## Arguments

\[role] - The role to add/remove as an activity role.

\[frequency] - The frequency to assign this activity role. Can be `Hourly`, `Daily`, `Weekly`, or `All-time`.

\[consecutive] - Boolean that denotes whether or not to allow consecutive winners of this active role.

\<exclusions> - List of roles that are excluded from this activity role.
{% endhint %}

This command allows you to add, remove, or view the activity roles list. This list denotes the settings and roles that activity roles will use.
{% endtab %}
{% endtabs %}