> ## Documentation Index
> Fetch the complete documentation index at: https://docs.razebot.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Stats Management

> Manually adjust or reset member tracking statistics and configure tracker manager permissions.

# Stats Management (Add, Remove, Reset)

<Badge variant="elite">Tier 1: Elite</Badge>

> Administrators and Tracker Managers can adjust, award, deduct, or reset message counts, voice activity time, and invite numbers for members or the entire server.

***

## Commands Overview

| Command    | Syntax                                  | Description                                             | Permissions             |
| :--------- | :-------------------------------------- | :------------------------------------------------------ | :---------------------- |
| `.add`     | `.add <subcommand> <@user> <amount>`    | Adds messages, voice time, or invites to a member.      | Administrator / Manager |
| `.remove`  | `.remove <subcommand> <@user> <amount>` | Deducts messages, voice time, or invites from a member. | Administrator / Manager |
| `.reset`   | `.reset <subcommand> [user/all]`        | Resets statistics for a specific member or all users.   | Administrator / Manager |
| `.manager` | `.manager <@role\|roleId>`              | Designates a manager role allowed to modify stats.      | Administrator           |

***

## Adding Stats

### add

Manually increment stats for event prizes, compensation, or server migrations.

| Subcommand | Scope                    | Syntax                                          | Example                        |
| :--------- | :----------------------- | :---------------------------------------------- | :----------------------------- |
| `message`  | `daily`, `weekly`, `all` | `.add message <scope> <@user\|userId> <amount>` | `.add message daily @User 100` |
| `voice`    | `daily`, `weekly`, `all` | `.add voice <scope> <@user> <time>`             | `.add voice daily @User 1h`    |
| `invite`   | —                        | `.add invite <@user\|userId> <amount>`          | `.add invite @User 5`          |

<Tabs>
  <Tab title="Add Messages">
    ```bash theme={null} theme={null}
    .add message daily @User 100
    .add message weekly @User 500
    .add message all @User 1000
    ```
  </Tab>

  <Tab title="Add Voice Time">
    ```bash theme={null} theme={null}
    .add voice daily @User 1h
    .add voice weekly @User 5h30m
    .add voice all @User 24h
    ```
  </Tab>

  <Tab title="Add Invites">
    ```bash theme={null} theme={null}
    .add invite @User 5
    ```
  </Tab>
</Tabs>

***

## Removing Stats

### remove

Deduct messages, voice time, or invites from a member.

| Subcommand | Scope                    | Syntax                                             | Example                          |
| :--------- | :----------------------- | :------------------------------------------------- | :------------------------------- |
| `message`  | `daily`, `weekly`, `all` | `.remove message <scope> <@user\|userId> <amount>` | `.remove message daily @User 50` |
| `voice`    | `daily`, `weekly`, `all` | `.remove voice <scope> <@user> <time>`             | `.remove voice daily @User 30m`  |
| `invite`   | —                        | `.remove invite <@user\|userId> <amount>`          | `.remove invite @User 2`         |

***

## Resetting Stats

### reset

Clear recorded stats for a member or perform a server-wide reset.

| Subcommand | Scope                    | Syntax                                     | Example                      |
| :--------- | :----------------------- | :----------------------------------------- | :--------------------------- |
| `message`  | `daily`, `weekly`, `all` | `.reset message <scope> [@user \| userID]` | `.reset message daily @User` |
| `voice`    | `daily`, `weekly`, `all` | `.reset voice <scope> [@user \| userID]`   | `.reset voice daily @User`   |
| `invite`   | —                        | `.reset invite [@user \| userID]`          | `.reset invite @User`        |

***

## Manager Role Delegation

### manager

Assign a tracker manager role so moderators can run `.add`, `.remove`, and `.reset` without needing full Discord Administrator permissions.

```bash theme={null} theme={null}
.manager @TrackerManagers
```

* **User Permissions**: Administrator