Quest database loaderKBVEQuestDB
A game-agnostic quest catalog plus an in-memory progress tracker. UKBVEQuestDatabase loads the shared questdb-data.json artifact into runtime quest and chain defs; UKBVEQuestProgressSubsystem tracks active quests against them. Saving progress stays game-side.
Catalog and tracker
Quest definitions are static data parsed through the generated questdb proto reader; progress lives in a separate subsystem and is not persisted by the plugin.
- Depends on — KBVEYYJson for JSON parsing.
- Scope — two GameInstance subsystems.
What it gives you
Features
GameInstance subsystem
UKBVEQuestDatabase and UKBVEQuestProgressSubsystem live at game-instance scope.
Data-driven defs
Parses questdb-data.json with yyjson and the generated KBVEQuestDBProto reader into FKBVEQuestDef and FKBVEQuestChainDef records.
Rich quest shape
Steps, objectives, choices, outcomes, prerequisites, time limits, rewards and repeat rewards, category, and chain per quest.
Lookup
Resolve quests and chains by ref, or list quests by category, tag, or giver NPC.
Progress tracking
Accept, advance objectives and steps, turn in, abandon, or fail quests, with status and objective events.
Wiring it up
Usage
Enable the KBVERegistry plugin (and its KBVEYYJson dependency) in your .uproject,
ship the questdb artifact to Content/Data/questdb-data.json, then query the
UKBVEQuestDatabase subsystem for quest defs. Drive play through
UKBVEQuestProgressSubsystem (AcceptQuest, AdvanceObjective, TurnInQuest, …)
and save its state game-side.
Questions
Frequently asked
What does KBVEQuestDB do?
It is a game-agnostic quest module of the KBVERegistry Unreal plugin. UKBVEQuestDatabase reads the shared questdb-data.json artifact into FKBVEQuestDef and FKBVEQuestChainDef records — steps, objectives, choices, prerequisites, rewards, category, and chain — with lookup by ref, category, tag, or giver NPC.
Does KBVEQuestDB track quest progress?
Yes, in memory. UKBVEQuestProgressSubsystem accepts, advances, turns in, abandons, and fails quests against the loaded defs, checks prerequisites, and fires OnQuestStatusChanged and OnObjectiveUpdated. It does not persist progress; saving it stays game-side.
What are its dependencies and requirements?
It depends on KBVEYYJson for JSON parsing and targets Unreal Engine 5.4+ on Win64, Linux, and Mac.
Discuss on the forum
Questions, fixes and notes on this page live in the KBVE forum.