> For the complete documentation index, see [llms.txt](https://docs.apollo-bot.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apollo-bot.xyz/commands/messages.md).

# Message Counter

Commands which are used to count/manage message counting in a server.

{% hint style="warning" %}
Inorder for message counter to work, you must enable it by using `a!messages enable`
{% endhint %}

### `a!messages`

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

* `a!messages [user]` - Check your/other user's number of messages in the server.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FmpLY2fA62UXyiEk4hlRb%2Fchrome_QO5xVQj1qg.gif?alt=media&amp;token=1ca4749c-6e3b-48e8-a503-05288558ff05" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!messages-admin add`

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

* `a!messages-admin add <member> <amt>` - Add a certain number of messages to an user.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FeCqsHbx8yVyXtjcwoDcL%2Fchrome_8PZrXJFuwF.gif?alt=media&amp;token=47718bdf-ab27-4653-9917-1af078108fb6" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!messages-admin remove`

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

* `a!messages remove <member> <amt>` - Remove messages from an user.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2F1TPGd0fQwouBOvTK3NP9%2Fchrome_f5tAeonCG9.gif?alt=media&amp;token=9feb984a-2bcd-4f90-9c34-9e547fbaad36" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!messages-admin enable`

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

* `a!messages enable` - Enables the message counter. *(Refer to top of the page)*
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FYgtpbDvs8wXqC5U4ApKY%2Fchrome_LQh7rXduEb.gif?alt=media&amp;token=fc71973d-acd7-45f6-accb-898baee80fd7" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!messages-admin disable`

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

* `a!messages disable` - Disables the message counter if it is enabled.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2F2xcjMT3m6Y4vcYXQlAPU%2Fchrome_X0zgLs2AwN.gif?alt=media&amp;token=6bed3d6e-62ad-4e62-92cd-ae295f8a2de8" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!messages reset` & `a!messages-admin reset-all`

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

* `a!messages-admin reset <user>` - Reset a member's message count to 0.
* `a!messages-admin reset-all` - Reset the entire server's message count to 0.

{% hint style="danger" %}
**WARNING - DESTRUCTIVE ACTION**

* Wrong usage of this command can cause all your message data to be reset.
* Make sure to mention the user if you are resetting messages for a single user.
* Erased data cannot be recovered, we do not store backups of deleted data.
  {% endhint %}
  {% endtab %}

{% tab title="Examples" %}

#### Reset messages for a single user:

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FJNFjJ7jPRxMvlVgSN9FP%2Fchrome_wEH1ckMj4U.gif?alt=media&amp;token=e99d7f6c-f414-48ae-be4f-f583fcd77cc8" alt=""><figcaption></figcaption></figure>

#### Reset messages for the entire server:

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2F2atDSbZ04XSAdqOuBcef%2Fchrome_eEbOX6YH4b.gif?alt=media&amp;token=b4671fd5-290c-4d2c-b4ac-fa027fafe78a" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!messages-admin settings`

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

* `a!messages settings` - Configure the message settings for the entire server.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FP8rxfnqhlG8NxZ09aC9n%2Fchrome_YnsfXJSDVY.gif?alt=media&amp;token=9561f2cd-be20-4f3d-bbd3-7b17a79bf2de" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### `a!leaderboard`

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

* `a!leaderboard` - View the current message leaderboard for the server.
  {% endtab %}

{% tab title="Examples" %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FRcJ1btSlaaJruM2tAMhn%2Fchrome_oStBAGv5M0.gif?alt=media&amp;token=81fe8e88-9200-4174-a5a4-4d8c403746e4" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Syntax usage:**

`<>` = Required argument (mandatory and must be included)

`[]` = Optional argument (not necessary to be included)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.apollo-bot.xyz/commands/messages.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
