Skip to content

KBVENPCDB

Game-agnostic NPC database + Mass Entity bridge. Mirrors the itemdb loader pattern but ships as a reusable plugin:

  • UKBVENpcDatabase (GameInstance subsystem) — loads Content/Data/npcdb-data.json (the shared npcdb codegen artifact) into FKBVENpcDef records; lookup by ref.
  • FKBVENpcDef / FKBVENpcStats — runtime NPC def (identity, stats, level, faction, abilities, tags, aggro, first-strike).
  • FKBVENpcFragment / FKBVENpcTag — Mass fragment + tag carrying the NPC’s db identity into the entity world.
  • UKBVENpcSpawner (World subsystem) — SpawnNpcEntity(Def) creates a Mass entity with the NPC fragment; the game adds its own fragments (stats, transform).

NPC DATA stays in the shared npcdb MDX; the plugin owns the load + Mass bridge. ChuckRPG calls it to spawn data-driven NPC entities.