> For the complete documentation index, see [llms.txt](https://litochee.gitbook.io/amaribot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://litochee.gitbook.io/amaribot/features/message-voice-xp.md).

# Message/Voice XP

{% hint style="warning" %}
To use the following commands you need `Administrator`or `AmariMod`role. Some commands may also require owner of server to have a premium account.
{% endhint %}

### Blacklist

| Name                                  | Example                   | Usage                                                                             |
| ------------------------------------- | ------------------------- | --------------------------------------------------------------------------------- |
| blacklist \<add/remove> <@role/ID>    | :?blacklist add @AmariMod | <p>Adds a role to the blacklist. <br>Blacklisted roles will not get exp</p>       |
| blacklist \<add/remove> <#channel/ID> | :?blacklist add #general  | <p>Adds a channel to the blacklist. <br>Blacklisted channels will not get exp</p> |
| blacklist \<show>                     | :?blacklist show          | Shows all blacklisted roles and channels                                          |

### Pmulti

{% hint style="info" %}
This is a premium feature for donators only. Donator is currently a one time payment and allows us to keep hosting the bot.
{% endhint %}

| Name                                           | Example                 | Usage                                                                                           |
| ---------------------------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------- |
| pmulti \<set> <1-100>                          | :?pmulti set 5          | Sets this server's global multiplier                                                            |
| <p>pmulti add <#channel/@role> <br><1-100></p> | :?pmulti add #general 5 | <p>Sets different exp rates for each <br>channel for role. Exp for all roles<br>stack</p>       |
| pmulti remove <#channel/@role>                 | :?pmulti add #general   | <p>Clears a channel or role custom <br>multiplier (resets to current <br>global multiplier)</p> |
| pmulti \<show>                                 | :?pmulti show           | <p>Shows all multipliers for channels<br>and roles</p>                                          |

### Reset

| Name              | Example                | Usage                                                      |
| ----------------- | ---------------------- | ---------------------------------------------------------- |
| reset <@user>     | :?reset @Litochee#5162 | Resets the specified user's exp                            |
| reset \<points>   | :?reset points         | Resets all users exp                                       |
| reset \<settings> | :?reset settings       | Resets all the settings for this server                    |
| reset \<all>      | :?reset all            | <p>Resets all users exp and this server's <br>settings</p> |

### Voice

{% hint style="info" %}
This is a premium feature for donators only. Donator is currently a one time payment and allows us to keep hosting the bot.
{% endhint %}

| Name                    | Example            | Usage                                                               |
| ----------------------- | ------------------ | ------------------------------------------------------------------- |
| voice \<enable/disable> | :?voice enable     | <p>Enable or Disable Voice Exp<br>(default is disabled)</p>         |
| voice exp <1-100>       | :?voice exp 5      | <p>Exp rate for voice exp (default 1)<br>(exp rate \* cooldown)</p> |
| voice cooldown <1-60>   | :?voice cooldown 2 | <p>Cooldown for voice exp <br>(default 2) (in minutes)</p>          |

### Weekly

| Name                  | Example              | Usage                                                                                                                                                                               |
| --------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| weekly \<on/off>      | :?weekly on          | Turns the weekly leaderboard on or off                                                                                                                                              |
| weekly \<winners>     | :?weekly winners     | <p>Announces the Top 3 winners of the <br>week and resets the leaderboard. <br>If unannounced, users exp will continue <br>to accumulate and the leaderboard will <br>not reset</p> |
| weekly \<leaderboard> | :?weekly leaderboard | <p>If enabled, shows the weekly leaderboard <br>for this server</p>                                                                                                                 |