# 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>                                                                                                                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://litochee.gitbook.io/amaribot/features/message-voice-xp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
