# Achievement Book

# Achievement Book

Since version 3.0.0 all player windows are one **achievement book** in the KyuubiSoft "Goldfiligran" look. It replaces the old gallery, title selection, rewards page, settings page and lootbag page.

| Way in | Opens on |
|--------|----------|
| `/ksachievements` (`/achievement`, `/ac`) | Overview |
| `/kstitles` (`/title`) | Titles |
| `/ksrewards` (`/reward`, `/rw`) | Rewards |
| Achievement Book item (right-click) | Overview |

:::note
The book is new in 3.0.0 and has not been tested in game yet.
:::

---

## Header and navigation

- **Header:** a status line, your points balance, a settings button and close.
- **Left navigation:** Overview, one line per category with "unlocked / total", Titles and Rewards. A gold marker shows when rewards are waiting.

## Overview

- Tiles for unlocked achievements, points, titles (with your active title) and your rarest achievement ("only n % of players have it").
- Every category with a progress bar and percent.
- A **Next title** box.
- **Almost done:** the 4 open achievements you are closest to.
- **Recently unlocked:** category, time, title and points.

Every line jumps to its category and entry.

## Category tabs

- Search field, filter pills **All / Open / Done**, sort **Default / Almost done / Recent**.
- **Chains are one line** with the current stage ("Stage 3 / 5").
- Each row shows the difficulty as a rarity ring (easy = common, normal = uncommon, hard = rare, epic = epic, legendary = legendary), a progress bar, a state chip and "in tracker".

### Detail panel

- Icon, name, category, difficulty and points, stage or done date.
- Description and a progress bar with counts.
- For chains, the **stage path**: done, current and locked stages with what each needs and the title it gives.
- Requirements with met markers.
- Reward slots: points, items (with the game's own item tooltip), lootbag, special rewards, and the title in its colour.
- Share of players who have it and the **server first** (player and date).
- **Track** / **In tracker** button ("Tracker full" when the limit is reached).

### Hidden achievements

Hidden achievements show as "???" without icon, progress, reward or title, and the search never finds them. The detail shows only the category, the share of players who found it and an optional hint. Hints are the text key `achievements.hint.<id>` in `localization/custom_<lang>.json`; without one the book says there is no hint.

### Special achievements

Achievements with the `manual` trigger (for example husbandry, fishing and farming achievements that have no tracker yet, and event achievements) show as **Special**. They unlock only through an admin grant or another mod.

## Titles tab

- Your active title with a **chat** and a **nameplate** preview in its real colour, and **Remove title**.
- Filter pills **All / Unlocked / Locked** with counts.
- 18 title cards per page: choose or active; locked cards show their source and progress; hidden ones show "???".

Dark title colours are lifted to a readable contrast inside the book only. See [Configuration](./configuration#display-settings) for how titles appear in chat and on nameplates.

## Rewards tab

See [Rewards](./rewards-ui).

## Settings

The gear in the header opens the book settings:

| Setting | Default |
|---------|---------|
| Show the tracker | on |
| Progress in the tracker | on |
| Track the next stage automatically | on |
| Hide the tracker when empty | on |
| Achievements in the tracker (1 to 3) | 3 |
| Language | opens the KyuubiSoft settings language page |

There is no position setting: since 3.1.6 the tracker has a fixed place on the screen (see [Tracker HUD](./tracker-hud)).

**Save** keeps the settings, **Default** resets them. With KyuubiSoft Core 2.8.0 or newer the same tracker options are also in the shared settings window `/kssettings`; both places change the same settings.

---

## Unlock notification

One notification per unlock combines the achievement, the points, the title (in its colour) and the reward hint. Depending on `notifications.displayMode` it is a HUD toast (`banner`, default for new installs), one chat line (`chat`) or both. See [Tracker HUD](./tracker-hud#unlock-toast).