# Rewards

# Rewards

Rewards of an achievement (items, lootbags, commands, MMO skill XP) wait in the **Rewards** tab of the [achievement book](./ui-pages) until the player collects them. Rewards survive restarts.

**Open it with:** `/ksrewards` (`/reward`, `/rw`) or the Rewards line in the book's navigation. A gold marker in the navigation shows that rewards are waiting.

---

## The Rewards tab

- **Waiting rewards**, each with its source achievement and reward slots (items show the game's own item tooltip).
- **Collect**, **Collect rest** or **Open** (lootbag) per reward.
- **Collect all** collects items, commands and XP at once.
- A partial-collect note when the inventory was full, for example "17 of 25 already collected · inventory was full".
- **Recently collected:** the last 50 collected rewards, saved with the player.

## Full inventory

Only what fits is handed out. The rest keeps waiting and can be collected later with **Collect rest**. Nothing is duplicated and nothing is lost.

## Lootbags

- A lootbag is **rolled once** and the result is saved. A relog or a half-full inventory never re-rolls it or hands it out twice.
- An opened bag shows only the items that still wait.
- Lootbags from very old player files (from the removed `/kslootbags` window) appear here as waiting rewards; the time they were earned is kept.

## Saving

Rewards are saved right after collecting or opening a lootbag, not only at the next auto-save.

## "Rewards waiting" hint

Once per session after join, players with waiting rewards get a hint (a HUD card or a chat line, following `notifications.displayMode`). The HUD card appears right below the compass, in the same rows as the unlock toast (see [Tracker HUD](./tracker-hud#unlock-toast)). Turn it off with `notifications.pendingRewardHint: false`.

---

## For admins

- The [players tool](./admin-panel#players-tool) of the admin window can deliver or remove a waiting reward, also for offline players (it runs at their next login).
- Revoking an achievement removes its rewards that were not collected yet. Rewards already collected stay with the player.

## Troubleshooting

| Problem | Check |
|---------|-------|
| Reward does not appear | Is the achievement really unlocked? Check the book or `/acadmin list <player>` |
| Lootbag shows nothing | The lootbag id must exist; the [check view](./admin-panel#check-view) reports unknown lootbags |
| Items stay waiting | Free inventory space, then **Collect rest** |