authoring-transaction.schema.json

1{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"Darkwind world transaction","type":"object","additionalProperties":false,"required":["format","baseRevision","baseHash","commands"],"properties":{"format":{"const":1},"baseRevision":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","description":"Exact uint64 revision; maximum 18446744073709551615."},"baseHash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"merge":{"const":"disjoint"},"commands":{"type":"array","minItems":1,"maxItems":256,"items":{"oneOf":[{"type":"object","additionalProperties":false,"required":["kind","place","id","value"],"properties":{"kind":{"const":"set-arrival"},"place":{"type":"string","minLength":1,"maxLength":256},"id":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object"}]},"index":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","place"],"properties":{"kind":{"const":"create-place"},"place":{"type":"object"},"index":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","place"],"properties":{"kind":{"const":"delete-place"},"place":{"type":"string","minLength":1,"maxLength":256}}},{"type":"object","additionalProperties":false,"required":["kind","entity","value"],"properties":{"kind":{"const":"set-object-portal"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"},"value":{"anyOf":[{"type":"null"},{"type":"object","additionalProperties":false,"required":["id","label","position","radius","destination"],"properties":{"id":{"type":"string","pattern":"^gateway\\.[a-f0-9-]{36}$"},"label":{"type":"string","minLength":1,"maxLength":256},"position":{"type":"array","minItems":3,"maxItems":3,"items":{"type":"number"}},"radius":{"type":"number","exclusiveMinimum":0,"maximum":5},"destination":{"type":"string","minLength":1,"maxLength":256},"destinationAnchor":{"type":"string","minLength":1,"maxLength":256},"window":{"type":"object","additionalProperties":false,"required":["offset","yaw","width","height","exit"],"properties":{"offset":{"type":"array","minItems":3,"maxItems":3,"items":{"type":"number","minimum":-100,"maximum":100}},"yaw":{"type":"number","minimum":-6.283185307179586,"maximum":6.283185307179586},"width":{"type":"number","minimum":0.1,"maximum":100},"height":{"type":"number","minimum":0.1,"maximum":100},"exit":{"type":"object","additionalProperties":false,"required":["position","yaw"],"properties":{"position":{"type":"array","minItems":3,"maxItems":3,"items":{"type":"number","minimum":-100,"maximum":100}},"yaw":{"type":"number","minimum":-6.283185307179586,"maximum":6.283185307179586}}}}}}}]},"index":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","entity","value"],"properties":{"kind":{"const":"set-object-behavior"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"},"value":{"anyOf":[{"type":"null"},{"type":"object","additionalProperties":false,"required":["id","label","position","radius","module","revision","configuration"],"properties":{"id":{"type":"string","pattern":"^behavior\\.[a-f0-9-]{36}$"},"label":{"type":"string","minLength":1,"maxLength":256},"position":{"type":"array","minItems":3,"maxItems":3,"items":{"type":"number"}},"radius":{"type":"number","exclusiveMinimum":0,"maximum":5},"module":{"type":"string","maxLength":128},"revision":{"type":"string","minLength":1,"maxLength":128},"configuration":{"type":"object"}}}]},"index":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","entity","value"],"properties":{"kind":{"const":"set-object-dialogue"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"},"value":{"anyOf":[{"type":"null"},{"type":"object","additionalProperties":false,"required":["id","label","text","position","radius"],"properties":{"id":{"type":"string","pattern":"^dialogue\\.[a-f0-9-]{36}$"},"label":{"type":"string","minLength":1,"maxLength":256},"speaker":{"type":"string","maxLength":256},"text":{"type":"array","minItems":1,"maxItems":64,"items":{"type":"string","minLength":1,"maxLength":4096}},"position":{"type":"array","minItems":3,"maxItems":3,"items":{"type":"number"}},"radius":{"type":"number","exclusiveMinimum":0,"maximum":5}}}]},"index":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","place","interaction","value"],"properties":{"kind":{"const":"set-dialogue"},"place":{"type":"string","minLength":1,"maxLength":256},"interaction":{"type":"string","minLength":1,"maxLength":256},"value":{"type":"object","additionalProperties":false,"required":["label"],"properties":{"label":{"type":"string","minLength":1,"maxLength":256},"speaker":{"type":"string","maxLength":256},"text":{"type":"array","maxItems":64,"items":{"type":"string","maxLength":4096}}}}}},{"type":"object","additionalProperties":false,"required":["kind","id","patch"],"properties":{"kind":{"const":"set-terrain"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$"},"patch":{"anyOf":[{"type":"null"},{"type":"object"}]},"index":{"type":"integer","minimum":0},"patchIndex":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","id","patch"],"properties":{"kind":{"const":"set-voxels"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$"},"patch":{"anyOf":[{"type":"null"},{"type":"object"}]},"index":{"type":"integer","minimum":0},"patchIndex":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","place","lights"],"properties":{"kind":{"const":"set-lighting"},"place":{"type":"string","minLength":1,"maxLength":256},"lights":{"type":"array","maxItems":8,"items":{"type":"object"}},"shadowLight":{"type":"integer","minimum":-1,"maximum":7}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-surface-graphs"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object","maxProperties":8,"propertyNames":{"pattern":"^[a-zA-Z][a-zA-Z0-9_-]{0,47}$"},"additionalProperties":{"type":"object"}}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-world-text"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"array","maxItems":32,"items":{"type":"object"}}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-buoyancy"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object"}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-swimming"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object"}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-water"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object"}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-weather"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object"}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-day-cycle"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object"}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-sky"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"object"}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","value"],"properties":{"kind":{"const":"set-particles"},"place":{"type":"string","minLength":1,"maxLength":256},"value":{"anyOf":[{"type":"null"},{"type":"array","maxItems":8,"items":{"type":"object"}}]}}},{"type":"object","additionalProperties":false,"required":["kind","place","property","value"],"properties":{"kind":{"const":"set-environment"},"place":{"type":"string","minLength":1,"maxLength":256},"property":{"enum":["ambient","fog","fogDensity","sun","sunIntensity"]},"value":{}}},{"type":"object","additionalProperties":false,"required":["kind","entity","property","value"],"properties":{"kind":{"const":"set"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"},"property":{"enum":["position","rotation","scale","material","visible","model","mesh","collider","platform","body","parent"]},"value":{}}},{"type":"object","additionalProperties":false,"required":["kind","entity","property","value"],"properties":{"kind":{"const":"set-group"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"},"property":{"enum":["position","rotation","scale","parent","id"]},"value":{}}},{"type":"object","additionalProperties":false,"required":["kind","place","object"],"properties":{"kind":{"const":"create"},"place":{"type":"string","minLength":1,"maxLength":256},"object":{"type":"object"},"index":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","entity"],"properties":{"kind":{"const":"delete"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"}}},{"type":"object","additionalProperties":false,"required":["kind","place","group"],"properties":{"kind":{"const":"create-group"},"place":{"type":"string","minLength":1,"maxLength":256},"group":{"type":"object"},"index":{"type":"integer","minimum":0}}},{"type":"object","additionalProperties":false,"required":["kind","entity"],"properties":{"kind":{"const":"delete-group"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"}}},{"type":"object","additionalProperties":false,"required":["kind","entity","source"],"properties":{"kind":{"const":"rename"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"},"source":{"type":"string","minLength":1,"maxLength":256}}},{"type":"object","additionalProperties":false,"required":["kind","entity","place"],"properties":{"kind":{"const":"move"},"entity":{"type":"string","pattern":"^authored:(?:[a-f0-9]{64}|[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12})$"},"place":{"type":"string","minLength":1,"maxLength":256},"source":{"type":"string","minLength":1,"maxLength":256}}},{"type":"object","additionalProperties":false,"required":["kind","asset","model"],"properties":{"kind":{"const":"put-model"},"asset":{"type":"string","minLength":1,"maxLength":256},"model":{"type":"object"}}},{"type":"object","additionalProperties":false,"required":["kind","asset"],"properties":{"kind":{"const":"remove-model"},"asset":{"type":"string","minLength":1,"maxLength":256}}},{"type":"object","additionalProperties":false,"required":["kind","format"],"properties":{"kind":{"const":"world-format"},"format":{"enum":[2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27]}}},{"type":"object","additionalProperties":false,"required":["kind","asset"],"properties":{"kind":{"const":"put-prefab-asset"},"asset":{"type":"object"}}},{"type":"object","additionalProperties":false,"required":["kind","id"],"properties":{"kind":{"const":"remove-prefab-asset"},"id":{"type":"string","minLength":1,"maxLength":256}}},{"type":"object","additionalProperties":false,"required":["kind","link"],"properties":{"kind":{"const":"put-prefab-instance"},"link":{"type":"object"}}},{"type":"object","additionalProperties":false,"required":["kind","id"],"properties":{"kind":{"const":"remove-prefab-instance"},"id":{"type":"string","minLength":1,"maxLength":256}}},{"type":"object","additionalProperties":false,"required":["kind","world"],"properties":{"kind":{"const":"replace-content"},"world":{"type":"object"},"textureTable":{"type":"object"},"prefabs":{"type":"object"},"terrain":{"type":"array","maxItems":4,"items":{"type":"object"}},"voxels":{"type":"array","maxItems":4,"items":{"type":"object"}}}}]}}},"description":"Validate-only review compiles the complete candidate. Nested worlds, models, prefabs, values, IDs and cross-references require semantic validation. replace-content must be the only command. Prepare new persistent identities once before submitting."}
2