Skip to content
unreal · quest

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.
KBVERegistryPlugin
UE 5.4+Engine
Win64 · Linux · MacPlatforms
KBVELicense

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.