Quest Item
No single model — varies at runtime
Field cell-object reference. Type tag: quest_item. The key words
MUST, MUST NOT, and MAY are
used as in RFC 2119. See the Cell Objects index
and the Field Stage Lifecycle for how
objects are spawned and persisted.
Config schema
Fields authored on this object in the stage JSON:
| Field | Type | Default | Note |
|---|---|---|---|
item_id | string | — | the objective count key this pickup increments |
label | string | — | display text for the HUD / log |
position | [x, y, z] | — | stage-local spawn position |
Spawn behavior
A collectible (the gold star) whose model varies by item — the viewer shows a placeholder. Placed from the stage config, sometimes gated on room_clear.
Persisted state
Persisted state is available → collected. A collected item MUST NOT reappear on re-entry.
Interactions
Walking over the item (or closing its pickup dialog) calls collect_quest_item(item_id) once, ticking the matching objective count toward its target.