KyuubiSoft Quest System - Changelog

New Features

NPC Quest Giver System

• 17 unique quest NPCs with full dialog trees (Offer, Active, Complete phases)
• Priority-based quest selection — NPCs offer the most relevant quest first
• Quest selection dialog when 2+ quests are available at the same NPC
• Multi-NPC quests — assign different NPCs for quest accept and turn-in
• Auto-actions: "start_quest" and "complete_quest" macros in NPC dialogs
• 306 localized dialog keys for all NPC text in English and German

Proximity System

• NPCs whisper context-aware chat messages when players walk nearby
• Configurable range (default: 20 blocks) and cooldown (default: 300 seconds)
• Phase-based messages — different text for offer, active, complete, and default states
• Wave animation on NPCs that have a quest to offer

Proximity Toast HUD

• On-screen display of nearby quest NPCs with icons
• Shows distance in blocks and compass direction (N/NE/E/SE/S/SW/W/NW)
• Updates every second for live distance tracking

Toast Notifications

• On-screen pop-up notifications for quest started, quest ready, quest complete, chapter complete
• Login notifications showing available and turn-in-ready quests (with NPC skin icons)
• Proximity toasts when walking near quest NPCs

QuestBook Redesign

• New layout matching the InfoHub design (wider panels, better spacing)
• Active quest sidebar shows up to 20 quests with individual objective progress
• Turn-in information shows NPC name and coordinates or "QuestBook"
• Stats tab with streak, tokens, completed count, active count
• NPC turn-in protection — quests assigned to NPCs show "Turn in at NPC" instead of claim button

HUD Improvements

• 5 objectives per quest (up from 3)
• Turn-in hints when all objectives are complete ("Turn in at NPC-Name" / "Open QuestBook")
• Type-specific names for "any" targets (e.g. "Defeat Enemies" instead of just "Defeat")
• Completed objectives show final count (e.g. "5/5") instead of truncated text

New Objective Types

• blocks_chopped — chop trees and wood
• blocks_dug — dig dirt, sand or gravel
• flowers_picked — pick flowers
• items_consumed — consume food or potions
• @consumable property target — matches all edible items regardless of naming pattern

Zone Discovery

• Zone polling system detects zone changes within a world every 2 seconds
• Instance world detection (e.g. Forgotten Temple) via world name extraction
• Deduplication — each zone counts only once per objective

QuestAPI

• Event listeners: onQuestStarted, onQuestCompleted, onQuestAbandoned
• Query methods: getAllQuestIds(), getQuestsByType()
• Facts database access: getPlayerFact(), setPlayerFact(), checkFactConditions()

Content

• 213 quest definitions: 31 Story (6 chapters), 14 Side, 120 Daily, 48 Weekly
• Quest Token Shop with 17 items in 6 categories
• Custom content support via custom/custom_*.json overrides
• Default config disable flags — load only your own custom quests

Full Localization

• All QuestBook, HUD, and admin panel text localized (English + German)
• ~800 i18n keys per language including quest names, descriptions, and all objective text
• Short language code resolution ("de" finds "de-DE" translations)
• ~310 German umlaut fixes and ~100 improved German quest descriptions

Improvements

• Quest Token Shop migrated to Core's generic shop system with currency registry
• Shop Tab removed from Quest Admin (managed via Core Shop Admin now)
• All admin panel labels fully localized
• Standardized footer buttons across all admin panels
• Config versioning system (v5) with automatic backup and re-extraction
• NPC Profile versioning (v2) with automatic updates on server start
• Difficulty field added to all 213 quests
• Reward balance adjustments (early story quests buffed, overpowered side quests reduced)
• Debug mode (/ksquestadmin debugmode) for live event tracking in chat

Bug Fixes

• Fixed: Auto-complete was never functional (GSON snake_case mismatch) — removed entirely, all quests now require manual turn-in
• Fixed: 24 NPC quests could not be completed at the NPC (missing complete_quest macro)
• Fixed: German translations falling back to English (short language code "de" not matching "de-DE")
• Fixed: QuestBook crashes from invalid UI selectors (DecoratedContainer and Group elements)
• Fixed: Weekly tab breaking the active quest sidebar (event bindings for hidden entries)
• Fixed: Craft+Place objectives losing progress when items were consumed after crafting
• Fixed: Plant_Wheat* not matching (correct ID is Plant_Crop_Wheat*)
• Fixed: Food_* target not matching all edible items (replaced with @consumable)
• Fixed: Distance-traveled objectives never progressing (target was "walking" but tracker sends "any")
• Fixed: HUD progress showing static "(0/N)" from description text instead of live count
• Fixed: Chat spam when objectives were already at max count
• Fixed: Quest selection not working when player already has an active quest from the same NPC
• Fixed: QuestBook NPC Turn-In bypass — quests with NPC turn-in can no longer be claimed via QuestBook
• Fixed: 88 incorrect item IDs and 8 entity IDs across all quest definitions
• Fixed: Proximity whisper running on wrong thread (causing SEVERE errors every 3 seconds)
• Fixed: Internal command references using old names instead of ks-prefixed names
• Fixed: Multiple tutorial quest complete dialogs using wrong format