# HUD Tracker

The quest tracker shows the quests a player tracks on the screen while they play. Version 2.0.0 rebuilt it with cards in the style of the pet HUD.

---

## What the tracker shows

One **card per tracked quest**:

- The quest icon with a rarity ring, the quest type and its state.
- The objectives with small progress bars (can be switched off).
- At the bottom either **"Claim in the Questbook"** or **"Turn in: NPC · distance"** once all objectives are done.

Below the cards, **"+ n more active"** counts running quests that are not shown. When a quest becomes ready, a short **ready-to-claim notice** appears right below the compass (can be switched off). It shares the rows there with the toasts of the other KyuubiSoft mods: it takes the highest free row and goes lower only while another toast is still on screen, so toasts never cover each other. This needs KyuubiSoft Core 2.9.9 or newer.

The tracker has a fixed place on the right of the screen, below the Season Pass card. It has a maximum height: cards that do not fit are counted in the "+ n more active" line. Nobody can move it: there is no position choice in the Questbook settings, in `/kssettings` or in the admin window.

The tracker hides while the world map is open and comes back when it closes. It attaches when the client is ready after joining, and re-attaches itself when another mod removes custom HUDs.

---

## Tracking quests

- Press **Track** in the [Questbook](./quest-book-ui) detail panel. Press **Tracked** to remove it again.
- A player can track up to 5 quests (`questTracker.maxTrackedQuests`, default 5).
- Finished quests leave the tracker on their own when **Auto-untrack** is on.
- Progress also counts for quests that are not tracked.

---

## Player settings

Each player sets the tracker in the Questbook settings (gear button, `/ksquest settings` or `/ksquestsettings`) or on the **Quests** page of the shared KS settings window (`/kssettings`). Both places change the same values, and changes apply at once.

| Setting | Values | Default |
|---------|--------|---------|
| Show tracker | on / off | on |
| Objectives in tracker | on / off | on |
| Ready-to-claim notice | on / off | on |
| Auto-untrack completed quests | on / off | on |
| Quests in tracker | 1 to 5 | 5 |
| Objectives per quest | 1 to 5 | 5 |

The **Default** button in the book switches every option on and sets both counts to 3 (a new player starts with 5, as in the table). **Save** applies it.

---

## Server defaults

New players start with the server's defaults from `config.json` (or the **Questbook & HUD** tab of the [admin window](./admin-panel)):

| Option | Default | Meaning |
|--------|---------|---------|
| `questTracker.enabled` | `true` | Tracker available on the server |
| `questTracker.showOnJoin` | `true` | Show the tracker right after joining |
| `questTracker.maxTrackedQuests` | `5` | How many quests a player can track |
| `questTracker.autoUntrackCompleted` | `true` | Remove finished quests from the tracker |
| `questTracker.defaultShowEmptyState` | `true` | Show an empty tracker card when nothing is tracked |

`questTracker.maxDisplayedQuests` and `maxDisplayedObjectives` have no effect any more: players choose the counts themselves. The older keys `questTracker.position` and `questTracker.defaultPositionPreset` are ignored.

---

## Proximity hint

When a player comes near a quest NPC, a hint with the NPC's picture appears at the bottom left of the screen, next to the Weapon Mastery display. It shows up to 4 NPCs at once.

| Option | Default | Meaning |
|--------|---------|---------|
| `proximityToast.enabled` | `true` | Show the hint |
| `proximityToast.toastRange` | `20.0` | Range in blocks |

Quest NPCs can also **whisper** in chat when a player comes close. Range, pause and texts are set per NPC in its [NPC profile](./npc-quest-profiles#proximity-detection).