> For the complete documentation index, see [llms.txt](https://docs.xandtech.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xandtech.fr/home/xtimerewards/reference/commands.md).

# Commands

{% hint style="info" %}
`/xtimerewards`'s extra aliases (`playtime` by default), `/afk`'s extra aliases, and `/daily`'s extra aliases (`dailystreak` by default) are all configurable in `config.yml`'s `commands` section — see [Installation & Setup](/home/xtimerewards/getting-started/getting-started.md#custom-command-names). `/xtimerewards`, `/xtr`, `/afk` and `/daily` always work regardless.
{% endhint %}

## `/xtimerewards` (aliases: `/xtr`, `/playtime`)

| Usage                               | Permission         | Description                                                                                    |
| ----------------------------------- | ------------------ | ---------------------------------------------------------------------------------------------- |
| `/xtimerewards`                     | `xtimerewards.use` | Opens the playtime menu (or prints a text summary if `playtime-menu.enabled` is off).          |
| `/xtimerewards top [period] [page]` | `xtimerewards.top` | Playtime leaderboard. `period`: `daily`/`weekly`/`monthly`/`yearly`/`total` (default `total`). |
| `/xtimerewards claim <id>`          | `xtimerewards.use` | Manually claims a milestone (`auto-claim: false` ones).                                        |
| `/xtimerewards streak`              | `xtimerewards.use` | Opens the daily-streak menu (same as `/daily`).                                                |
| `/xtimerewards streaktop [page]`    | `xtimerewards.top` | Streak leaderboard.                                                                            |

## `/afk`

| Usage             | Permission             | Description                                                                                              |
| ----------------- | ---------------------- | -------------------------------------------------------------------------------------------------------- |
| `/afk`            | `xtimerewards.afkmode` | Opens the confirmation menu to enter AFK mode — or, if already in it, just re-shows the persistent menu. |
| `/afk top [page]` | `xtimerewards.afkmode` | AFK-mode lifetime-seconds leaderboard.                                                                   |

## `/daily` (alias: `/dailystreak`)

| Usage    | Permission            | Description                        |
| -------- | --------------------- | ---------------------------------- |
| `/daily` | `xtimerewards.streak` | Opens the daily login-streak menu. |

## `/xtimerewards admin ...`

Every subcommand below requires **`xtimerewards.admin`**.

| Usage                                          | Description                                                                                                                         |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `/xtimerewards admin reload`                   | Reloads config, languages, milestones, menus, every reward file, the streak-freeze craft recipe, and re-checks for a plugin update. |
| `/xtimerewards admin view <player>`            | Opens the [per-player admin GUI](/home/xtimerewards/features/admin-tools.md).                                                       |
| `/xtimerewards admin alts [page]`              | Opens the [shared-IP account browser](/home/xtimerewards/features/admin-tools.md#multi-account-shared-ip-detection).                |
| `/xtimerewards admin export [yaml\|json\|csv]` | [Exports every known account's data](/home/xtimerewards/features/admin-tools.md#data-export) (defaults to `yaml`).                  |

### Milestones (playtime counters)

| Usage                                                              | Description                                                        |
| ------------------------------------------------------------------ | ------------------------------------------------------------------ |
| `/xtimerewards admin milestone set <player> <period> <seconds>`    | Sets that period's playtime counter to an exact value.             |
| `/xtimerewards admin milestone add <player> <period> <seconds>`    | Adds to it (also adjusts the lifetime total in lockstep).          |
| `/xtimerewards admin milestone remove <player> <period> <seconds>` | Subtracts from it (also adjusts the lifetime total).               |
| `/xtimerewards admin milestone reset <player>`                     | Resets all five counters (daily/weekly/monthly/yearly/total) to 0. |

`<period>` is `daily`/`weekly`/`monthly`/`yearly`/`total`.

### Streaks

| Usage                                                        | Description                                                                                                              |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `/xtimerewards admin streak set <player> <days>`             | Sets the current streak to an exact value.                                                                               |
| `/xtimerewards admin streak add <player> <days>`             | Adds days to it.                                                                                                         |
| `/xtimerewards admin streak remove <player> <days>`          | Subtracts days from it.                                                                                                  |
| `/xtimerewards admin streak reset <player>`                  | Resets the current streak to 0 (keeps the longest-ever record).                                                          |
| `/xtimerewards admin streak freeze set <player> <amount>`    | Sets banked freeze-charge count to an exact value.                                                                       |
| `/xtimerewards admin streak freeze add <player> <amount>`    | Adds freeze charges.                                                                                                     |
| `/xtimerewards admin streak freeze remove <player> <amount>` | Removes freeze charges.                                                                                                  |
| `/xtimerewards admin streak freeze give <player> [amount]`   | Hands over the **physical** Streak Freeze item (default `amount`: 1) — the player banks it themselves by right-clicking. |

### AFK mode

| Usage                                     | Description                                                |
| ----------------------------------------- | ---------------------------------------------------------- |
| `/xtimerewards admin afk setafk <player>` | Force-enters that player into AFK mode.                    |
| `/xtimerewards admin afk unafk <player>`  | Force-exits that player from AFK mode.                     |
| `/xtimerewards admin afk reset <player>`  | Resets their lifetime AFK-mode seconds counter.            |
| `/xtimerewards admin afk setpoint`        | Sets the AFK-mode teleport point to your current location. |

See [Permissions](/home/xtimerewards/reference/permissions.md) for the full permission reference, and each feature page for the underlying mechanics.


---

# 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://docs.xandtech.fr/home/xtimerewards/reference/commands.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.