Entity Reference

NPC Builder’s Context API is organized in four layers.
Use this reference to see every entity type and which fields you can update programmatically.

Context hierarchy

World

Highest in-game realm or server—houses regions and locations.

Region

Optional zone or chapter inside a world (e.g. “Northern Kingdom”).

Location

Precise place such as towns, dungeons, or rooms.

Character

Individual NPC tied to a specific world, region or location.

Editable properties

World
Region
Location
Character

name – max 25 chars
lore – back-story, max 1400 chars
creatures – free-text list, max 75 chars
similarWorlds – string array of related worlds

name – max 25 chars
lore – max 1400 chars
weather – short weather descriptor, max 25 chars
culture – customs / population style, max 125 chars
politicalStability – enum:
none, highlyStable, stable, moderatelyStable, unstable, highlyUnstable, anarchy

name – max 25 chars
lore – max 1400 chars
role – purpose of the place, max 25 chars (e.g. “Trade hub”)

name – max 25 chars
description – bio, max 1400 chars
age – enum: infant • child • teenager • youngAdult • adult • middleAged • elderly
gender – “Male”, “Female”, or free text
role – narrative role enum (e.g. protagonist, questGiver, …)
tone – dialogue tone enum: formal • casual • sarcastic • mysterious • emotive
traits – string array (avoid opposite trait pairs: brave/coward, kind/cruel, …)
items – array of
itemName, unit, value (each max 25 chars)
quests – array of
description, objective, reward (each max 125 chars)

For request schemas, example payloads, and enum lists, open the OpenAPI explorer.

Getting started

Game Engine Integration

Context hierarchy

World

Region

Location

Character

Editable properties

​Context hierarchy

World

Region

Location

Character

​Editable properties

Context hierarchy

Editable properties