> For the complete documentation index, see [llms.txt](https://guide.bocto.octopeeps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.bocto.octopeeps.com/plugins/utilities/user-activity-tracker.md).

# User Activity Tracker

## <mark style="color:$primary;">Use Case.</mark>

This feature was originally invented to help us count users' messages during our daily live rumbles on **OctoPeeps** server, which we run in person, starting it manually. Of course, we want to encourage our users to make us a company and have some fun in the chat together. That is why we provide custom rumble rewards depending on the number of messages users have sent during the match.

However, counting all the messages manually every time was always quite annoying. Now, the <mark style="color:$primary;">**User Activity Tracker**</mark> does it for us. And, since this is our only use case for this utility at the moment, in this guide, we will demonstrate how this feature works specifically on it.

So, before we start the rumble, we launch the <mark style="color:$primary;">**User Activity Tracker**</mark> using `/start-activity-tracker` command. Now, every time users post messages or GIFs, Bocto counts them:

<figure><img src="/files/YnPLJqeZqXfJ5V13hBIV" alt=""><figcaption></figcaption></figure>

And when the rumble is over, we stop the <mark style="color:$primary;">**User Activity Tracker**</mark> using `/stop-activity-tracker` command and get the embed message with the results:

<figure><img src="/files/Cf4j4iDpu2BAHgAj5Hta" alt=""><figcaption></figcaption></figure>

Now we can use this data to give different amounts of coins to users, thus making the reward process much fairer, rather than using the default rumble results, which do not take into account real users' engagement.

## <mark style="color:$primary;">Feature Specifics.</mark>

* This feature does not count messages shorter than one character unless they are an emoji, image, or GIF.
* Being started, this feature works across all your channels. That is, you can not launch more than one tracker at a time.
* If you want to exclude messages in certain channels or from certain roles, or admins from the count, you can set the exceptions in the [feature configuration](https://app.gitbook.com/o/PP99adWq6pg0a9ekqlE1/s/nX757myueIMa0YXG4HJl/~/changes/69/plugins/utilities/user-activity-tracker#user-activity-tracker-configuration).
* This function can only be started and stopped manually when needed using the available commands.

## <mark style="color:$primary;">User Activity Tracker Activation.</mark>

To activate the <mark style="color:$primary;">**User Activity Tracker**</mark>, go to the <mark style="color:$primary;">**Select a Plugin**</mark> page and click on the <mark style="background-color:purple;">`≡ Features`</mark> button on the <mark style="color:blue;">**Utilities**</mark> card.

<figure><img src="/files/pvHAwmuCT1T908C7xv8i" alt=""><figcaption></figcaption></figure>

Now, activate the <mark style="color:$primary;">**User Activity Tracker**</mark> by clicking on the switcher on the corresponding card, and confirm activation.

<figure><img src="/files/lLWlxsYtSrSv7M9DnOo2" alt=""><figcaption></figcaption></figure>

## <mark style="color:$primary;">User Activity Tracker Configuration.</mark>

After activation is done, you need to configure the feature. To do this, click the <mark style="background-color:purple;">`≡ Configure`</mark> button on this card to visit the feature settings page.

<figure><img src="/files/Blq8BDuk9Q0N2L8I0Y7b" alt=""><figcaption></figcaption></figure>

On the settings page, there are two sections.&#x20;

In the <mark style="color:$success;">SETTINGS</mark> section, you can exclude admins from the count if you don't want they to participate in the activity competition.

In the <mark style="color:$success;">PERMISSIONS</mark> section, you can exclude certain roles from the count if you don't want they to participate in the activity competition, or certain channels if you don't want to count messages in certain channels during the event.

<figure><img src="/files/5OCsJ6A76SBGrOB9iy8N" alt=""><figcaption></figcaption></figure>

## <mark style="color:$primary;">Available Commands.</mark>

`/start-activity-tracker`  Start tracking the number of messages sent by users in the current channel.
\
`/stop-activity-tracker`  Stop tracking users' activity in the current channel.


---

# 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 dynamically by asking a question.

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

```
GET https://guide.bocto.octopeeps.com/plugins/utilities/user-activity-tracker.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.