# Quest Book UI

Since version 2.0.0 the Questbook is one window in the KyuubiSoft look. `/ksquest`, the Quest Book item and the showcase NPC all open the same window.

---

## Opening the Questbook

| Way | Notes |
|-----|-------|
| `/ksquest` | Needs `ks.quest.user.use` (granted by default) |
| `/ksquest settings` or `/ksquestsettings` | Opens the book on its settings window. Needs `ks.quest.user.settings` (granted by default) |
| Quest Book item | Right-click the item. The server can hand it out on join (`questItem.giveOnJoin`, off by default) |
| Core dialogs | The dialog action "Open window" can open `questbook` and `questbook.settings` |

---

## Layout

![The Questbook on the Daily tab](../../../../assets/quest-system/quests-book-daily.png)

| Area | What it shows |
|------|---------------|
| **Navigation** (left) | The tabs, the quest token balance, a settings button and, when the quest streak is on, a streak box |
| **Quest list** (middle) | The quests of the selected tab, with a reset countdown on the daily and weekly tabs |
| **Detail panel** (right) | Everything about the selected quest, and the buttons for it |

### Tabs

| Tab | Contents |
|-----|----------|
| **Daily** | Today's daily quests and the time until the next daily reset |
| **Weekly** | This week's weekly quests and the time until the next weekly reset |
| **Story** | A chapter map (finished, current and locked chapters) and the quests of the selected chapter |
| **Side quests** | Side quests and every quest that is not daily, weekly or story (hub and pack quests too) |
| **Active** | Every running quest. Progress also counts for quests you do not track |
| **Chronicle** | Lifetime totals and your completed quests |

---

## Detail panel

- **Difficulty chip** with the reward multiplier of the quest's tier.
- **Objectives**, each with its own progress bar and item icon.
- **Rewards** as item slots with rarity rings and the game's item tooltips, plus a quest token slot. The amounts shown already include the tier factor and the daily or weekly token bonus, so they match what is paid out.
- **Quest giver** with a portrait and a turn-in hint ("Go to Gorn to receive your reward").
- **Buttons** that follow the quest's state:

| Button | When |
|--------|------|
| **Start quest** | The quest is available and handed out by the book |
| **Accept at** *NPC* | The quest is handed out in person by a quest giver |
| **Claim reward** | Every objective is done and no NPC turn-in is needed |
| **Claim at** *NPC* | Every objective is done and the quest is turned in at a quest giver |
| **Reroll** | Daily or weekly quest that can be rerolled |
| **Abandon** | Running quest. A confirmation warns about items you already handed in |
| **Track** / **Tracked** | Running quest. Adds it to or removes it from the HUD tracker |

Every button acts on the quest it belongs to, even if the list changed in the meantime.

---

## Reroll window

Shows the price (free or paid), the free rerolls left today or this week and your balance before you confirm. Paid rerolls double in price with each use. You are only charged when another quest was found and the payment succeeded; if no other quest is available, nothing is charged and a free reroll is not used up. The window shows the result afterwards. See [Daily & Weekly Pools](./daily-weekly-pools#reroll-system).

---

## Chronicle

- **Totals:** quests completed (daily, weekly, other), tokens earned, longest streak and story progress.
- **History:** completed quests grouped by day, newest first, with the filters All, Daily, Weekly, Story and Side.
- Every completion is stored with type, time, tokens and item rewards (the last 200 per player). Data from before 2.0.0 starts from the per-type counters the mod already kept.

---

## Settings window

The gear button opens the settings inside the book; **Save** keeps the book open.

| Setting | What it does |
|---------|--------------|
| Show tracker | Shows or hides the quest tracker HUD |
| Objectives in tracker | Shows the objectives on the tracker cards |
| Ready-to-claim notice | The notice below the compass when a quest is ready |
| Auto-untrack completed quests | Removes finished quests from the tracker |
| Quests in tracker | 1 to 5 |
| Objectives per quest | 1 to 5 |
| Language | Shows your language. **Change** opens the language page of the shared KS settings, where one choice applies to all KS mods |

The same tracker options are on the Quests page of `/kssettings`. See [HUD Tracker](./hud-tracker).

---

## Quest giver window

Talking to a quest NPC opens the quest giver window (it replaced the old four-button selection in 2.0.0):

- A **greeting** from the NPC.
- A **"ready to claim"** strip with the rewards and a **Claim** button when you have finished a quest this NPC takes in.
- **All offered quests as cards**, three per page, with objectives, rewards and the reason a quest is still locked (shown with the quest's name).

Accepted quests go to your Questbook and tracker. Quest givers stand still while their window is open and walk on when it is closed.

## Delivery confirmation

When you talk to a quest giver that still needs items from you, a confirmation window shows exactly what it takes. Items are only taken after **Hand in**, only what is still missing, and only what really left your inventory counts. If you abandon the quest later, delivered items are not returned. This works for Citizens NPCs and plain NPCs.

---

## Token balance

Your quest token balance is shown in the navigation. Tokens are earned from quests and spent on rerolls and in the Quest Token Shop. On servers in economy mode the book shows the economy currency instead.