# Changelog

# Quest System Changelog

A summary of all notable changes, organized by version.

---

## v2.1.9 — 2026-11-10 — Guild objectives

Not released yet and not tested in game.

### New

- **Guild objectives for [KyuubiSoft Guilds](https://wiki.kyuubisoft.com/hytale/guilds/).** The quest editor has a fifth row of objective types: join a guild, found a guild, reach a guild level, lock chests or doors for the guild, and hand in materials for the guild (any item or chosen items). Admins build their own quests on them; no shipped quest uses them. Joining and founding count once per player, so leaving and joining again does not count twice, and each locked spot counts once. See [Guild Objectives](./objectives#guild-objectives).
- **Guild experience for quests.** With KyuubiSoft Guilds, every completed quest also gives the player's guild experience, within the guild's daily limit per member.
- **The check view knows the guild objectives.** A guild level must be a number, and the check warns when KyuubiSoft Guilds is not running, because such objectives would never progress then.
- **Paid rerolls say what they were for.** With the server currency [Kronen](https://wiki.kyuubisoft.com/hytale/core/kronen/), a paid reroll appears in the history as `Daily quest rerolled` or `Weekly quest rerolled`, in the reader's language.

---

## v2.1.8 — 2026-11-09 — Design & Feature Update

Release of the Design & Feature Update. It sums up the changes since 1.12.7.

### New

- **New Questbook.** `/ksquest` or the QuestBook item opens one book with the tabs Daily, Weekly, Story, Side quests, Active and Chronicle, your quest tokens and the reset countdowns. Each quest shows its objectives with progress bars, its rewards with the game's item tooltips and its quest giver, the Story tab maps your chapters, and the Chronicle lists every quest you completed.
- **Quest giver window.** A quest giver shows the quests you can claim and every quest it offers, with objectives, rewards and the reason a quest is still locked. When you bring items, it shows exactly what it takes and takes only what is still missing, after you press "Hand in".
- **New quest tracker.** Tracked quests appear as cards at the right edge of the screen, below the Season Pass card, and a notice below the compass tells you when a quest is ready to claim. Players change the tracker in the Questbook settings or in `/kssettings`.
- **Quests admin window.** Admins with `ks.quest.admin` open it with `/ksquestadmin panel` or from the `/ksadmin` hub to edit quests, chapters, pools, NPC profiles and settings in the game and to see statistics. Every change stays a draft until "Save", each save keeps a backup, and "Undo last save" brings the previous state back.
- **Quest editor.** Texts in every language, 20 objective types, 11 reward types with their final values, triggers, follow-up quests and NPC phases, with a player preview and "Test for me". A check view with about 75 rules finds problems and jumps to them.
- **Chapters and pools.** Edit each chapter's quest chain and unlock rules, and the daily and weekly pools with weights, chances and a rotation preview. A weight of 0 now means "never drawn".
- **Players tool.** Start, complete or reset quests, give or take tokens, set streaks and facts, or deliver waiting rewards, for online and offline players. Every action is logged and can be reverted, and "View questbook" shows a player's book read-only.
- **Quests in NPC dialogs.** NPC dialogs made with KyuubiSoft Core can start a quest, set facts and check whether a quest is ready to turn in. Core's NPC management lists every quest that uses an NPC before you rename or delete it.
- **New options.** A real quest streak with milestone rewards, an all-dailies bonus, free rerolls per week, reset announcements and a cooldown for repeatable quests. Their defaults keep the old behaviour.

### Changed

- **Rewards that never arrived are paid.** With KyuubiSoft Achievements, achievement and title rewards now grant the achievement or title instead of 25 tokens, and achievement requirements work. XP rewards written as `amount` grant that XP.
- **Resets on time.** Daily and weekly resets run at the configured time in the configured time zone, also across daylight saving changes. A new reset time applies after `/ksquestadmin reload`.
- **NPC turn-ins check everything.** The NPC dialog action "complete quest" now claims the quest normally, so objectives and handed-in items are checked.
- **Fixed HUD places.** The tracker position can no longer be changed, so the HUDs of the KyuubiSoft mods no longer overlap; saved positions and `questTracker.position` are ignored. Nearby quest NPCs show as up to 4 icons in the bottom left corner.
- **One language choice.** Players pick their language once in `/kssettings` for every KyuubiSoft mod. Every text exists in 9 languages, and quotes and dates follow the reader's language.

### Fixed

- **Dailies and weeklies come back.** They no longer stay "completed" forever, and a reset no longer abandons quests that are ready to claim.
- **Collect goals count what you carry.** Items already in your inventory count as soon as you accept the quest.
- **No lost or doubled rewards.** Item and lootbag rewards that do not fit wait as pending rewards and are never handed out twice. A quest that takes items checks them first and takes nothing when they are missing.
- **Questbook buttons and rerolls.** A button could act on a different quest after the list changed, for example "Abandon". A reroll is now only paid when another quest was found.
- **Your files are safe.** A broken player file is kept in `players_corrupt/` and story facts are saved. A broken `config.json`, language or admin file is never overwritten, and edits to `quest_token_shop.json` are no longer replaced at every start.
- **Objectives that got stuck.** Wait objectives survive relogs and restarts, level goals are checked after a level-up, group goals from older quests count again, and permission requirements are checked.
- **Admin commands work.** `setstreak`, `resetdaily` and `resetweekly` now do what they say, and `export`, `import`, `tokens`, `spawnmerchant` and the other `/ksquestadmin` commands read their arguments, for example `/ksquestadmin tokens 50`.
- **Small fixes.** Quest givers walk again after their window closes, side quests without an NPC are visible again, `notifications.progressThreshold = 0` no longer freezes the server, the tracker hides while the world map is open, and `/kslang` without an argument answers in chat.

### Before you update

- Update KyuubiSoft Core to 2.9.9 or newer first.
- Admins who add or change command rewards or NPC actions that run as the server console need `ks.core.admin.dialog.console`, also for web editor imports.
- Exports of the old admin panel in `custom/` overwrote later changes at every restart. They are moved once to `exports/legacy-panel/`, and a log line names quests that existed only there.

---

## v2.1.3 — 2026-10-28

### Fixed

- **Quotes in every language.** Names, dialog lines and node IDs that the admin window puts in quotes use straight quotes ("...") in every language. Before they always had German quotes, in English and the other languages too.
- **Dates in the player tool follow the admin's language** (last seen, chronicle, log, waiting rewards). English shows month/day ("10/22 13:05"), German stays "22.10. 13:05". Times stay 24-hour server time.
- The day headings of the questbook chronicle show day and month in the reader's order (English "Oct 21").

## v2.1.2 — 2026-10-28

### Fixed

- **The way back to Core's NPC management.** An NPC profile opened with **Quest profile …** from `/kscitizen edit` always keeps its way back: **Back** leads to that NPC on the Talk tab. The button in the profile header and on the **Create profile** page is there from the start, and the way back is no longer lost after the questbook view or Core's dialog editor. If no way back is known, **Back** opens Core's NPC management on that NPC's Talk tab.
- The item picker of the admin window opens as a framed window with a dimmed background (before it floated over the page without a background).
- The NPC search field in the NPC profile list no longer takes half of the list column.

## v2.1.1 — 2026-10-23

Not tested in game yet.

### Added

- **"View questbook" also works for offline players.** The admin sees the saved state of that player, read only: the header says it is the saved state, all actions and settings are hidden, and nothing is written. With Core 2.9.2 the saved data is only looked at (a broken player file stays where it is); with an older Core it is read like at a login, which can move a broken file aside. While an offline book is open, the token balance stays empty when tokens are paid through an economy plugin, and quests that need a level, a skill or a permission count as not available.
- **"Open in Core's dialog editor"** in an NPC profile opens the NPC's first Core dialog; closing it returns to the same profile and keeps the draft. The button only shows when the installed Core offers the editor.
- Chapter rewards got everything the quest editor's reward builder has: a picker for achievements and titles, the lootbag contents, hints when a plugin or the Achievements mod is missing, and the console lock for command rewards.

### Changed

- **One reward builder** for the quest and chapter editor. Chapter rewards still have no tier factor, so they show no final values.
- `quest_token_shop.json` follows the update rule of the other shipped files: a newer shipped version replaces it and keeps the old one as `quest_token_shop.json.backup-v<N>`. While the shipped file carries no version, server edits are never touched. The shipped shop is unchanged.
- Quest prerequisites (quests, achievements, facts, level, skill, permission) are checked in one place for the live player and for a saved state.

### Fixed

- **Web editor imports follow the console rule** (with Core 2.9.2): without `ks.core.admin.dialog.console`, an import can no longer add, change or remove command rewards that run as the console, in quests and chapters. Such rewards stay as they are on the server and the rest of the import is applied; the web editor result lists the kept entries. An NPC profile whose console actions changed is not imported.
- An action queued for an offline player is no longer lost when the player leaves again right after logging in.
- A console command reward can no longer be changed through the currency or value field of a reward row without the console permission.

## v2.1.0 — 2026-10-23 — New admin window

The old admin panel is replaced by one admin window in the KyuubiSoft look (`/ksquestadmin panel`, the `/ksadmin` hub, the `showcase_quests` NPC). Every change is a draft until **Save**. See [Admin Window](./admin-panel). Not tested in game yet.

### Added

- **Window:** global search, navigation in three groups with counters, a footer with the draft, a change list (each change can be reverted), Discard and Save, and a confirmation before closing with unsaved changes.
- **Saving:** errors block saving, warnings do not. Every save makes a backup set and writes atomically; on a failure everything is rolled back. Changes apply at once. "Save anyway?" when another admin saved the same objects. **Undo last save**; the last 20 backups are kept. Admin files only contain what differs from the shipped content.
- **Quests list** with search, filters, sort orders and language completeness; new quests from 6 templates, duplicate, delete with restore, rename with "Used in".
- **Quest editor** with basics, texts per language, objectives (20 types), rewards (11 types, final values after the tier factor), flow (chapter chain, follow-up quest, fact, requirements, triggers, repeat options) and NPC phases; player preview and **Test for me**.
- **Check view** with about 75 rules and "Go to".
- **Chapters** editor with story path, quest chain, unlock rules in three modes, quick fixes, chapter rewards and auto-start.
- **Pools** side by side with "chance approx. %", a "Not in pool" list and a rotation preview. **Weight 0** now means "never drawn" (a missing weight is still 1).
- **Players** tool for online and offline players with 11 actions (queued for offline players), a log with revert, and **View questbook** (read only).
- **Statistics** with average and best time, abandon rate, problem quests and export.
- **Settings** in four tabs. No value or default was changed.
- **NPC profiles** as a tab, with node editor, phase preview and **Test dialog**. From Core's NPC management, **Back** returns to that NPC.
- Dialog action **Set fact** in NPC profiles (`set_fact:name=value`).
- Core dialog condition **Quest ready to turn in** (`quest_ready`).
- **Repeat cooldown** for repeatable quests (`options.repeat_cooldown_hours`, default 0 = as before).
- Command `/ksquestadmin npcprofile [citizenId]`.
- On a showcase server, visitors can browse the admin window read only.

### Changed

- Every way into the admin window needs `ks.quest.admin`. Console commands (command rewards, NPC profile console actions) also need `ks.core.admin.dialog.console`, checked again when saving and importing.
- Exports go to `exports/` only. Old panel exports in `custom/` are moved once to `exports/legacy-panel/`, because they overrode later changes on every restart.
- `quest_token_shop.json` is extracted once instead of being replaced on every start, so edits to it are kept.
- Texts an admin adds in only one language fall back to that language instead of showing the raw key.

### Fixed

- Group targets from older data (a group name without `group:`) count again.
- `wait` can be chosen as an objective type; a `deliver` objective without a target NPC can be handed in at any NPC.
- Triggers now apply `setsFact` and `completesObjective`.
- Admin commands run on the player's world thread and say so when the player has no world at the moment.
- A console import with command rewards was always rejected, even from the server console.
- Autosave can no longer stop for good after one failed step.
- A broken admin file, `config.json` or language file is no longer replaced silently on save: saving stops and names the file.
- The chapter editor no longer drops chapter rewards, `autoChain` and the fact value.
- Deleted shipped NPC profiles no longer come back on restart.

## v2.0.3 — 2026-10-22 — Dialog actions and facts (with Core 2.9.0)

- **Start quest** as a dialog action in Core's dialog editor. It uses the same start as the Questbook, so all requirements apply; the editor checks the quest ID and warns about auto-start quests. If the quest cannot start, the player is told why in chat.
- While Quests is loaded, the Core dialog action **Set fact** and the condition **fact** use the Quests player facts: a dialog can unlock quest requirements and check facts like `chapter_<id>_completed`. Auto-start quests that a fact unlocks start right away.
- Before an NPC's ID is changed or the NPC is deleted, Core's NPC management lists everything Quests links to it.
- The dialog action "Open window" can open `questbook` and `questbook.settings`.
- Quests still runs on older Core versions; the new hooks are then skipped.
- The conditions `quest_active`, `quest_completed` and `quest_available` no longer write a log line for every check.

## v2.0.2 — 2026-10-21 — KS settings page (with Core 2.8.0)

- Quest tracker options in the shared KS settings window (`/kssettings`): tracker on or off, objectives, ready-to-claim notice, auto-untrack, how many quests and objectives, position.
- The language line in the Questbook settings has a **Change** button that opens the shared language page; one choice applies to all KS mods.
- The `/ksadmin` hub entry shows the real mod version.
- A tracker shown while the world map is open now starts hidden.

## v2.0.1 — 2026-10-21 — Reward fixes (with Core 2.7.4)

- Item rewards with a full inventory are kept as pending rewards only for the part that did not fit, and pending items are never queued twice.
- Lootbag rewards that do not fit keep their rolled items as pending rewards instead of losing them or paying 30 tokens. Streak milestone lootbags do the same.
- Old lootbag reward IDs resolve again through Core 2.7.4.
- Web editor: localization edits only accept plain language codes.

## v2.0.0 — 2026-10-20 — New Questbook and 27 bug fixes

### Added

- **New Questbook** in the KyuubiSoft look with the tabs Daily, Weekly, Story, Side quests, Active and Chronicle, a detail panel, a story chapter map, a chronicle of completed quests, and settings, abandon and reroll windows inside the book. See [Quest Book UI](./quest-book-ui).
- **Quest giver window** with all offered quests as cards and a "ready to claim" strip, and a **delivery confirmation** that takes items only after "Hand in".
- **New quest tracker HUD** with one card per tracked quest and a ready-to-claim notice. See [HUD Tracker](./hud-tracker).
- **Real quest streak** (days with at least one completed daily), off by default: `streak.questStreak` and `streak.rewardsEnabled`.
- New options (defaults keep the old behaviour): `economy.tokenEarnings.allDailiesBonusEnabled`, `reroll.freeRerollsPerWeek`, `reroll.maxPaidRerollsPerWeek`, `notifications.announceResets`, `economy.tokenShopUsesEconomy`.
- `/ksquestadmin claim <player> <quest>`; `setstreak`, `resetdaily` and `resetweekly` work now.
- Prerequisites of type `permission` are checked. `notifications.broadcastCompletion`, `questTracker.showOnJoin` and the quest options `rerollable`, `trackable`, `repeatable` and `hidden` work.

### Changed

- **Rewards that were never delivered are paid now:** achievement and title rewards are granted (they always became 25 tokens), and XP rewards written as `amount` grant that XP.
- Resets run at the configured time and time zone as one-shot tasks; changes apply after `/ksquestadmin reload`, daylight saving no longer moves them, and a login before the reset no longer causes a second reset.
- `/ksquestadmin reload` no longer re-extracts the shipped defaults; it also re-registers triggers and chapters, reloads NPC profiles and plans the resets again.
- The NPC "complete quest" action now claims normally (objectives checked, consumed items verified) instead of force-completing.
- New installs get a production `config.json` (English, debug off, 300 s save interval).
- Quest giver names and generic objective texts follow the player's language in all 9 languages.
- `/ksquestadmin browseitems` was removed.

### Fixed

- Dailies and weeklies no longer stay "completed" forever: they can be done again when they come back.
- A reset no longer abandons quests that are ready to claim.
- Rerolls are only charged when another quest was found and the payment succeeded.
- Achievement prerequisites and achievement and title rewards work with the Achievements mod.
- `notifications.progressThreshold = 0` froze the server; values are limited to 1-100.
- The quest editor no longer drops `consumeItems`, `deliverTo` and conditions on save.
- Claiming a quest with `consumeItems` checks the items first.
- Wait objectives survive relogs and restarts; `level_reached` objectives are checked again after level-ups.
- Story facts and completed chapters are saved reliably.
- Corrupt player files are backed up to `players_corrupt/` instead of being replaced silently.
- Book buttons always act on the right quest, also after the list changed.
- Statistics count every completion.
- The reward preview matches what is paid out.
- Side quests from neither an NPC nor a pack are visible again.
- The tracker attaches reliably after joining and re-attaches when another mod removes custom HUDs.
- Quest givers walk on when their window is closed.

## v1.8.1 – v1.12.8 — 2026-03-17 to 2026-10-20

- **1.12.8:** `/kslang` without an argument answers in chat.
- **1.12.5:** `consumeItems` now removes the items when a quest is completed with `/ksquestadmin complete`.
- **1.12.0:** Hytale 0.6.0 compatibility. Every admin subcommand is gated by `ks.quest.admin`; several test and admin subcommands had no permission check before. Player commands keep their `ks.quest.user.*` checks.
- **1.10.0:** new quest option `auto_claim` (completes the quest as soon as the last objective is done), chapter option `autoChain` (starts the next quest of the chapter), auto-start quests start when their prerequisites are met, `sequential` objectives are respected, `testfirstjoin` works for players with completed quests.
- **1.9.4:** the tracker and proximity HUDs use Hytale's keyed HUD API; MHUD is no longer needed.
- **1.8.1:** switching off custom content no longer empties the custom files; the `custom/` folder is backed up first.
- Rebuilds for the Hytale 0.5.0, 0.6.x and 0.7.0 servers.

---

## v1.7.0 — 2026-03-15

### New Features

- **NPC Profile Editor** — Edit NPC quest profiles directly in the admin panel with live preview
- **Stats Tracking** — Server-wide and per-player quest statistics with aggregated completion rates
- **Economy Display** — Full UI integration when using external currency mode; all labels, tooltips, and shop pages reflect the configured currency name
- **Gold Reroll** — Quest rerolls can be paid with Gold as an alternative to quest tokens; admin control via `rerollCostTokens` and `rerollCostGold`
- **Per-Instance Tooltips** — Item tooltips customized per-player using PacketAdapters for quest items with player-specific progress
- **Pending Reward Retry** — Items that couldn't be granted due to full inventory are automatically retried on next login with player notification
- **MySQL Backend** — Player quest data stored in MySQL for cross-server setups; automatic legacy file migration; table `ks_quest_players`
- **QuestAPI** — Cross-mod integration API with event listeners (`onQuestStarted`, `onQuestCompleted`, `onQuestAbandoned`), query methods, and Facts API

### Improvements

- **Per-Player Language** — Players set their preferred language with `/kslang`; all quest UI, notifications, and NPC dialogs respect the setting
- **`talk_to_npc` Alias** — New objective type alias for NPC interaction objectives
- **LevelingCore Integration** — RPG XP rewards correctly granted via LevelingCore API
- **Proximity Toast Fixes** — Better handling of HUD conflicts; diagnostic logging when MHUD is unavailable
- **Admin Console Permission Fix** — Console operators can now use all admin commands without permission node requirements

---

## 2026-03-03

- **Per-Player Language Support** — Players can now set their preferred language with `/kslang`. All quest UI, notifications and NPC dialogs respect the player's language setting. Supported: `en-US`, `de-DE`.
- **Memory Leak Fix** — Player data is now properly cleaned up on disconnect across all mods. Prevents memory growth on long-running servers.

## 2026-02-25

- **Per-Instance Tooltips** — Item tooltips can now be customized per-player using PacketAdapters. Virtual item IDs allow unique descriptions for the same base item (e.g. quest items with player-specific progress).
- **Packet Interception API** — New `PacketAdapters.registerOutbound/Inbound()` for intercepting and modifying network packets. Used for dynamic item descriptions and command tracking.

---

## 2026-02-21

- **Economy Display** — When `rewardCurrency = "economy"` is configured, the entire Quest UI shows the external currency (e.g. "Gold") instead of "Quest Tokens". Automatic conversion via `tokenExchangeRate`. New central `CurrencyHelper` singleton handles all display logic.
- **Pending Reward Retry** — Items that couldn't be granted due to full inventory are now automatically retried on next login. Players are notified if delivery still fails.
- **MySQL Storage Backend** — Player quest data can optionally be stored in MySQL for cross-server setups. Automatic legacy file migration on first load. Table: `ks_quest_players`.

## 2026-02-20

- **Gold Reroll** — Quest rerolls can now be paid with Gold (external economy) as an alternative to quest tokens. Admin control via `rerollCostTokens` and `rerollCostGold`. Reroll popup dynamically shows 1 or 2 buttons based on configuration and economy availability.
- **RewardCurrency** — New config `economy.rewardCurrency`: set to `"economy"` to grant external currency (e.g. Gold) instead of quest tokens for all quest rewards. Conversion via `tokenExchangeRate`. Fallback to tokens if external economy is unavailable.
- **Admin Save Fix** — Base quests edited in the admin panel (objectives, rewards) now persist after server restart.
- **RPG XP Reward Fix** — Quest reward type `RPG_XP` now grants XP correctly via RPGLevelingAPI.
- **Quest Selection Redesign** — NPC quest selection dialog completely redesigned with DecoratedContainer for consistent styling.
- **WARN Spam Reduction** — Hot-path warnings in InventoryChangeTrackerSystem and QuestProximityToastManager downgraded to FINE level.

---

## 2026-02-18

- **Auto-Complete Removed** — The `auto_complete` / `auto_reward` fields were never functional (GSON snake_case/camelCase mismatch). Removed from code and all 168 quest JSONs. All quests now require manual turn-in via QuestBook or NPC.
- **Quest Audit** — 8 bug fixes across quest data:
  - Missing `tutorial_gateway` complete dialog added to Guide Finn's profile
  - Duplicate title/achievement rewards removed from `story_temple_revelation` and `story_final_sage`
  - Lootbag ID corrected in `story_temple_revelation`
  - Block targets fixed in `story_frost_cobalt` (Armory) and `story_frost_magic` (Arcane)
  - `daily_craft_food` objective type corrected from `items_collected` to `items_crafted`
  - `daily_zone_rare` count increased from 1 to 2
- **Difficulty Field** — Added `difficulty` (easy/medium/hard/legendary) to all 213 quests
- **Reward Balancing** — Daily common tokens 2 -> 3; tutorial quest tokens increased; some side quest tokens reduced for balance
- **Config Version 5** — Automatic re-extraction of all base configs and NPC profiles when updating
- **NPC Profile Versioning** — `_config_version` field added to all 17 NPC profiles; version-aware extraction with backup on update
- **QuestAPI** — New cross-mod integration API with event listeners (`onQuestStarted`, `onQuestCompleted`, `onQuestAbandoned`), query methods (`getAllQuestIds`, `getQuestsByType`), and Facts API (`getPlayerFact`, `setPlayerFact`, `checkFactConditions`)
- **Language Code Fix** — `getForLanguage("de")` now correctly resolves to `"de-DE"` translations; ~310 broken umlauts fixed; ~100 quest descriptions rewritten in proper German
- **QuestBook Crash Fixes** — 3 server crashes from invalid UI selectors fixed (DecoratedContainer macro slots, Group.Text properties); all nested selectors converted to flat IDs
- **QuestBook i18n** — Tooltip texts, main title, and HUD labels now use localization keys
- **Proximity Toast Diagnostics** — Better logging when HUD conflicts prevent proximity toast display; warning when MHUD plugin is not available
- **Test NPC Cleanup** — Removed `citizen_3` and `citizen_4` test profiles that referenced non-existent quests

---

## 2026-02-16

- **Quest Token Shop Custom Support** — Override or add shop items via `custom/custom_quest_token_shop.json`
- **NPC Turn-In Fix** — 24 NPC quests now correctly complete at the NPC instead of showing "Check your quest book"
- **HUD Fixes** — Progress displays correctly after re-login; completed objectives show final count (e.g., "5/5"); fixed a rollback bug where placed/consumed crafted items reset progress
- **Item/Entity ID Validation** — 96 corrections across all quest files after cross-checking against game data
- **@consumable Target** — New `"target": "@consumable"` matches all consumable items instead of relying on `Food_*` prefix
- **Quest Book Objectives** — Cards now show detailed per-objective status (completed, in-progress, locked)
- **HUD 5 Objectives** — Tracker expanded from 3 to 5 objectives per tracked quest

:::info Debug Mode
Toggle live tracking debug with `/ksquestadmin debugmode` to see all events in chat.
:::

---

## 2026-02-15

- **Zone Discovery Dedup** — Each zone counts only once per objective; new polling system detects zone changes every 2s
- **Tutorial Turn-In Fix** — 7 tutorial quests now complete correctly at the guide NPC with unique dialogs
- **HUD Turn-In Indicator** — Shows "Turn in at NPC-Name" or "Open Quest Book" when all objectives are done
- **Proximity Toast** — Distance and compass direction displayed above NPC icons; lightweight 1s refresh
- **Quest Book Turn-In** — Active quests show turn-in location with NPC name and coordinates
- **NPC Dialog i18n** — 306 new localization keys; all 15 NPC profiles converted from hardcoded German to i18n keys with full English translations

---

## 2026-02-14

- **Content Pack** — 213 quest definitions: 31 story (6 chapters), 14 side quests, 120 daily (10 pools x 4 tiers), 48 weekly (3 categories x 4 tiers)
- **Quest Token Shop** — 17 items across 5 categories, purchasable with quest tokens
- **Toast Notifications** — On-screen popups for quest start/ready/complete/available and chapter complete; login notifications for pending quests; proximity toasts with NPC skin icons

:::tip Daily/Weekly Pools
Quests are drawn from weighted random pools. Higher tiers (Rare, Epic, Legendary) give better rewards but appear less frequently.
:::

---

## 2026-02-13

- **Chat Spam Fix** — Repeated triggers no longer send duplicate completion notifications
- **NPC Dialog Fix** — NPCs no longer show "all done" dialog when prerequisites are not yet met
- **Command Name Fix** — Internal references updated to correct `ks`-prefixed command names
- **Localization Bump** — Version increased to ensure deployed servers pick up new keys

---

## 2026-02-12

- **NPC Quest Profile System** — One NPC can offer multiple quests with priority-based selection, quest chains via `requires`, and multi-NPC quest phases
- **Quest Selection Dialog** — When 2+ quests are available, the NPC shows a selection UI with outline buttons
- **NPC Quest Markers** — World map markers auto-update based on quest status (available, in-progress, turn-in)
- **Proximity Whisper** — NPCs whisper chat messages to nearby players based on quest phase; configurable range and cooldown
- **Shop Migration** — Quest Token Shop migrated to Core Shop system; 11 legacy files removed
- **Admin Panel** — Full in-game admin with 8 tabs (General, Systems, Player, Economy, Content, Chapters, Shop, Stats), CRUD editors, search/filter, import/export, and dynamic language support

:::note Custom Content
Place additional quest files in the `custom/` folder. They are auto-loaded and merged with base content. Use `disabled_base_ids` to deactivate specific base quests.
:::

---

## 2026-02-10

- **Core Tracking Migration** — 7 ECS systems replaced by centralized Core TrackingService with anti-jitter and anti-teleport filtering
- **Admin Panel i18n** — 150+ localized label keys (EN + DE); language changes propagate from Core Admin
- **Custom Icons** — HUD, Quest Book buttons, pagination, and settings use custom icon textures with tooltips

---

## 2026-02-09

- **Quest Admin Panel** — Initial release with vertical sidebar navigation, quest/chapter editor, and economy settings
- **Quest Book UI** — 5 quest slots per page with pagination, tracking toggle, accept/drop/claim/reroll buttons, settings page, and Quest Token Shop access