750 lines
15 KiB
JSON
750 lines
15 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"title": "StoryNode",
|
|
"description": "An immutable branch event with its state delta and player-facing presentation.",
|
|
"type": "object",
|
|
"properties": {
|
|
"action_id": {
|
|
"type": "string"
|
|
},
|
|
"beats": {
|
|
"type": "array",
|
|
"default": [],
|
|
"items": {
|
|
"$ref": "#/$defs/PresentationBeat"
|
|
}
|
|
},
|
|
"branch_id": {
|
|
"type": "string"
|
|
},
|
|
"can_continue": {
|
|
"type": "boolean",
|
|
"default": true
|
|
},
|
|
"character": {
|
|
"$ref": "#/$defs/PresentationCharacter",
|
|
"default": {
|
|
"expression": null,
|
|
"id": "",
|
|
"name": "",
|
|
"pose": null
|
|
}
|
|
},
|
|
"delta": {
|
|
"$ref": "#/$defs/StateDelta"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"parent_id": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"scene": {
|
|
"$ref": "#/$defs/PresentationScene",
|
|
"default": {
|
|
"id": "",
|
|
"title": ""
|
|
}
|
|
},
|
|
"state_hash": {
|
|
"type": "string"
|
|
},
|
|
"story_id": {
|
|
"type": "string"
|
|
},
|
|
"suggestions": {
|
|
"type": "array",
|
|
"default": [],
|
|
"items": {
|
|
"$ref": "#/$defs/ActionSuggestion"
|
|
}
|
|
},
|
|
"user_input": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"story_id",
|
|
"branch_id",
|
|
"action_id",
|
|
"user_input",
|
|
"delta",
|
|
"state_hash"
|
|
],
|
|
"$defs": {
|
|
"AcquisitionMode": {
|
|
"type": "string",
|
|
"enum": [
|
|
"initial",
|
|
"found",
|
|
"given",
|
|
"borrowed",
|
|
"stolen",
|
|
"returned"
|
|
]
|
|
},
|
|
"ActionSuggestion": {
|
|
"type": "object",
|
|
"properties": {
|
|
"draft": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"label": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"label",
|
|
"draft"
|
|
]
|
|
},
|
|
"BeatKind": {
|
|
"type": "string",
|
|
"enum": [
|
|
"narration",
|
|
"dialogue",
|
|
"action",
|
|
"system"
|
|
]
|
|
},
|
|
"CheckDifficulty": {
|
|
"type": "string",
|
|
"enum": [
|
|
"regular",
|
|
"hard",
|
|
"extreme"
|
|
]
|
|
},
|
|
"CheckRecord": {
|
|
"type": "object",
|
|
"properties": {
|
|
"action_id": {
|
|
"type": "string"
|
|
},
|
|
"actor": {
|
|
"type": "string"
|
|
},
|
|
"bonus_dice": {
|
|
"type": "integer",
|
|
"format": "int8",
|
|
"maximum": 127,
|
|
"minimum": -128
|
|
},
|
|
"difficulty": {
|
|
"$ref": "#/$defs/CheckDifficulty"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"node_id": {
|
|
"type": "string"
|
|
},
|
|
"pushed_from": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"result": {
|
|
"$ref": "#/$defs/CheckResult"
|
|
},
|
|
"roll": {
|
|
"type": "integer",
|
|
"format": "uint8",
|
|
"maximum": 255,
|
|
"minimum": 0
|
|
},
|
|
"skill": {
|
|
"type": "string"
|
|
},
|
|
"target": {
|
|
"type": "integer",
|
|
"format": "uint8",
|
|
"maximum": 255,
|
|
"minimum": 0
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"action_id",
|
|
"actor",
|
|
"skill",
|
|
"target",
|
|
"difficulty",
|
|
"bonus_dice",
|
|
"roll",
|
|
"result",
|
|
"node_id"
|
|
]
|
|
},
|
|
"CheckResult": {
|
|
"type": "string",
|
|
"enum": [
|
|
"critical_success",
|
|
"extreme_success",
|
|
"hard_success",
|
|
"success",
|
|
"failure",
|
|
"fumble"
|
|
]
|
|
},
|
|
"ItemAcquisition": {
|
|
"type": "object",
|
|
"properties": {
|
|
"at_node": {
|
|
"type": "string"
|
|
},
|
|
"from": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"mode": {
|
|
"$ref": "#/$defs/AcquisitionMode"
|
|
}
|
|
},
|
|
"required": [
|
|
"mode",
|
|
"at_node"
|
|
]
|
|
},
|
|
"ItemInstance": {
|
|
"type": "object",
|
|
"properties": {
|
|
"acquisition": {
|
|
"$ref": "#/$defs/ItemAcquisition"
|
|
},
|
|
"condition": {
|
|
"type": "string"
|
|
},
|
|
"holder": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"owner": {
|
|
"type": "string"
|
|
},
|
|
"placement": {
|
|
"$ref": "#/$defs/ItemPlacement"
|
|
},
|
|
"quantity": {
|
|
"type": "integer",
|
|
"format": "uint32",
|
|
"minimum": 0
|
|
},
|
|
"spec_ref": {
|
|
"type": "string"
|
|
},
|
|
"state_tags": {
|
|
"type": "array",
|
|
"default": [],
|
|
"items": {
|
|
"type": "string"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"spec_ref",
|
|
"owner",
|
|
"holder",
|
|
"placement",
|
|
"quantity",
|
|
"condition",
|
|
"acquisition"
|
|
]
|
|
},
|
|
"ItemPlacement": {
|
|
"type": "string",
|
|
"enum": [
|
|
"bag",
|
|
"worn",
|
|
"hand",
|
|
"scene",
|
|
"hidden"
|
|
]
|
|
},
|
|
"KnowledgeCertainty": {
|
|
"type": "string",
|
|
"enum": [
|
|
"suspected",
|
|
"reported",
|
|
"confirmed"
|
|
]
|
|
},
|
|
"KnowledgeRecord": {
|
|
"type": "object",
|
|
"properties": {
|
|
"certainty": {
|
|
"$ref": "#/$defs/KnowledgeCertainty"
|
|
},
|
|
"fact": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"last_verified_at": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"learned_at": {
|
|
"type": "string"
|
|
},
|
|
"observer": {
|
|
"type": "string"
|
|
},
|
|
"source": {
|
|
"type": "string"
|
|
},
|
|
"subject": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"observer",
|
|
"fact",
|
|
"certainty",
|
|
"source",
|
|
"learned_at"
|
|
]
|
|
},
|
|
"PresentationBeat": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"kind": {
|
|
"$ref": "#/$defs/BeatKind"
|
|
},
|
|
"speaker": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"text": {
|
|
"type": "string"
|
|
},
|
|
"visual": {
|
|
"anyOf": [
|
|
{
|
|
"$ref": "#/$defs/VisualDirective"
|
|
},
|
|
{
|
|
"type": "null"
|
|
}
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"kind",
|
|
"text"
|
|
]
|
|
},
|
|
"PresentationCharacter": {
|
|
"description": "Resolved public visual state for the primary character at a committed node.\n\n`expression` and `pose` are the final values after the node's beats have\nplayed. Persisting the resolved values means restoring a node does not need\nto replay an earlier branch to reconstruct the current portrait.",
|
|
"type": "object",
|
|
"properties": {
|
|
"expression": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
],
|
|
"default": null
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"name": {
|
|
"type": "string"
|
|
},
|
|
"pose": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
],
|
|
"default": null
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"name"
|
|
]
|
|
},
|
|
"PresentationScene": {
|
|
"description": "Public scene identity frozen at a committed story node.\n\nThis is presentation data, not authoritative world state. In particular it\nmust never contain unrevealed scene facts or trigger conditions.",
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"title": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"title"
|
|
]
|
|
},
|
|
"Promise": {
|
|
"type": "object",
|
|
"properties": {
|
|
"accepted_at": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"content": {
|
|
"type": "string"
|
|
},
|
|
"created_at": {
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"promisee": {
|
|
"type": "string"
|
|
},
|
|
"promiser": {
|
|
"type": "string"
|
|
},
|
|
"resolved_at": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"status": {
|
|
"$ref": "#/$defs/PromiseStatus"
|
|
},
|
|
"weight": {
|
|
"$ref": "#/$defs/PromiseWeight"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"promiser",
|
|
"promisee",
|
|
"content",
|
|
"status",
|
|
"weight",
|
|
"created_at"
|
|
]
|
|
},
|
|
"PromiseStatus": {
|
|
"type": "string",
|
|
"enum": [
|
|
"proposed",
|
|
"accepted",
|
|
"fulfilled",
|
|
"broken",
|
|
"released",
|
|
"impossible"
|
|
]
|
|
},
|
|
"PromiseWeight": {
|
|
"type": "string",
|
|
"enum": [
|
|
"minor",
|
|
"major"
|
|
]
|
|
},
|
|
"RelationshipAdjustment": {
|
|
"type": "object",
|
|
"properties": {
|
|
"cause": {
|
|
"type": "string"
|
|
},
|
|
"delta": {
|
|
"type": "integer",
|
|
"format": "int16",
|
|
"maximum": 32767,
|
|
"minimum": -32768
|
|
},
|
|
"dimension": {
|
|
"$ref": "#/$defs/RelationshipDimension"
|
|
},
|
|
"judgment_rule": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"dimension",
|
|
"delta",
|
|
"cause"
|
|
]
|
|
},
|
|
"RelationshipDimension": {
|
|
"type": "string",
|
|
"enum": [
|
|
"affinity",
|
|
"trust",
|
|
"hope",
|
|
"respect",
|
|
"intimacy",
|
|
"attachment"
|
|
]
|
|
},
|
|
"StateDelta": {
|
|
"type": "object",
|
|
"properties": {
|
|
"ops": {
|
|
"type": "array",
|
|
"default": [],
|
|
"items": {
|
|
"$ref": "#/$defs/StateOp"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"StateOp": {
|
|
"oneOf": [
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"key": {
|
|
"type": "string"
|
|
},
|
|
"op": {
|
|
"type": "string",
|
|
"const": "set_world_flag"
|
|
},
|
|
"value": {
|
|
"type": "boolean"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"key",
|
|
"value"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"adjustment": {
|
|
"$ref": "#/$defs/RelationshipAdjustment"
|
|
},
|
|
"from": {
|
|
"type": "string"
|
|
},
|
|
"op": {
|
|
"type": "string",
|
|
"const": "adjust_relationship"
|
|
},
|
|
"to": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"from",
|
|
"to",
|
|
"adjustment"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"op": {
|
|
"type": "string",
|
|
"const": "create_promise"
|
|
},
|
|
"promise": {
|
|
"$ref": "#/$defs/Promise"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"promise"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"op": {
|
|
"type": "string",
|
|
"const": "update_promise"
|
|
},
|
|
"promise_id": {
|
|
"type": "string"
|
|
},
|
|
"resolved_at": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"status": {
|
|
"$ref": "#/$defs/PromiseStatus"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"promise_id",
|
|
"status"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"op": {
|
|
"type": "string",
|
|
"const": "add_knowledge"
|
|
},
|
|
"record": {
|
|
"$ref": "#/$defs/KnowledgeRecord"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"record"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"item": {
|
|
"$ref": "#/$defs/ItemInstance"
|
|
},
|
|
"op": {
|
|
"type": "string",
|
|
"const": "add_item"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"item"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"from": {
|
|
"type": "string"
|
|
},
|
|
"item_id": {
|
|
"type": "string"
|
|
},
|
|
"mode": {
|
|
"$ref": "#/$defs/AcquisitionMode"
|
|
},
|
|
"op": {
|
|
"type": "string",
|
|
"const": "transfer_item"
|
|
},
|
|
"placement": {
|
|
"$ref": "#/$defs/ItemPlacement"
|
|
},
|
|
"to": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"item_id",
|
|
"from",
|
|
"to",
|
|
"placement",
|
|
"mode"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"check": {
|
|
"$ref": "#/$defs/CheckRecord"
|
|
},
|
|
"op": {
|
|
"type": "string",
|
|
"const": "record_check"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"check"
|
|
]
|
|
},
|
|
{
|
|
"type": "object",
|
|
"properties": {
|
|
"clock_id": {
|
|
"type": "string"
|
|
},
|
|
"delta": {
|
|
"type": "integer",
|
|
"format": "uint16",
|
|
"maximum": 65535,
|
|
"minimum": 0
|
|
},
|
|
"op": {
|
|
"type": "string",
|
|
"const": "advance_clock"
|
|
}
|
|
},
|
|
"required": [
|
|
"op",
|
|
"clock_id",
|
|
"delta"
|
|
]
|
|
}
|
|
]
|
|
},
|
|
"VisualDirective": {
|
|
"type": "object",
|
|
"properties": {
|
|
"character": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"expression": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"pose": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
},
|
|
"scene": {
|
|
"type": [
|
|
"string",
|
|
"null"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|