Skip to content

quest/

Quest graph and task/recipe definitions used by game and narrative runtimes.


Canonical format

Quest files are multi-document YAML (documents separated by ---). The first document declares the quest graph; subsequent documents define recipes and tasks referenced in the quest.

apiVersion: net.plantange/v1
kind: simulation.quest

meta:
  name: <name>
  version: <semver>
  genome: "<hex>"

nodes:
  <node_id>:
    type: obtain         # player must acquire the artifact
    artifact: <item_id>

  <node_id>:
    type: craft          # player combines inputs to produce output
    requires: [<id>, ...]
    produces: <id>
---
apiVersion: net.plantange/v1
kind: simulation.item

meta:
  name: <name>

tags: [<tag>, ...]

Node types

type: Meaning
obtain Acquire a named artifact
craft Combine requires inputs to produce an output
deliver Bring an artifact to a location or recipient

File inventory

File Kind State
quest_make_stew.yml quest + items (multi-doc) migrating