World manifest 0.1
Schema reference / World manifest / 0.1
The data-only world.json at the root of every world package: scene entry, spawns, areas, anchors, mounts, collision, playable bounds, atmosphere and provenance.
Raw schema
{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://hyprune.com/schema/v0/world.schema.json", "title": "Hyprune v0 world", "type": "object", "properties": { "formatVersion": { "const": "0.1" }, "id": { "$ref": "common.schema.json#/$defs/id" }, "version": { "$ref": "common.schema.json#/$defs/version" }, "name": { "type": "string", "minLength": 1, "maxLength": 256 }, "description": { "type": "string", "minLength": 0, "maxLength": 4096 }, "license": { "type": "string", "minLength": 1, "maxLength": 256 }, "scene": { "allOf": [ { "$ref": "common.schema.json#/$defs/path" }, { "pattern": "\\.(gltf|glb)$", "type": "string" } ] }, "preview": { "$ref": "common.schema.json#/$defs/path" }, "defaultSpawn": { "$ref": "common.schema.json#/$defs/slug" }, "spawns": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "common.schema.json#/$defs/slug" }, "pose": { "$ref": "common.schema.json#/$defs/pose" }, "node": { "$ref": "common.schema.json#/$defs/index" } }, "required": [ "id", "pose" ], "additionalProperties": false }, "minItems": 1 }, "attribution": { "type": "array", "items": { "type": "object", "properties": { "path": { "anyOf": [ { "$ref": "common.schema.json#/$defs/path" }, { "const": "." } ] }, "author": { "type": "string", "minLength": 1, "maxLength": 256 }, "license": { "type": "string", "minLength": 1, "maxLength": 256 }, "source": { "type": "string", "minLength": 1, "maxLength": 2048, "pattern": "^https://" } }, "required": [ "path", "author", "license" ], "additionalProperties": false }, "minItems": 1 }, "zones": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "common.schema.json#/$defs/slug" }, "name": { "type": "string", "minLength": 1, "maxLength": 256 }, "bounds": { "type": "object", "properties": { "min": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "max": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 } }, "required": [ "min", "max" ], "additionalProperties": false } }, "required": [ "id", "name", "bounds" ], "additionalProperties": false }, "minItems": 0 }, "anchors": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "common.schema.json#/$defs/slug" }, "pose": { "$ref": "common.schema.json#/$defs/pose" }, "size": { "type": "array", "items": { "type": "number", "exclusiveMinimum": 0 }, "minItems": 2, "maxItems": 2 }, "screenType": { "$ref": "common.schema.json#/$defs/id" }, "node": { "$ref": "common.schema.json#/$defs/index" } }, "required": [ "id", "pose", "size", "screenType" ], "additionalProperties": false }, "minItems": 0 }, "navigation": { "type": "object", "properties": { "kind": { "const": "mesh" }, "node": { "$ref": "common.schema.json#/$defs/index" }, "agentRadius": { "type": "number", "exclusiveMinimum": 0 }, "agentHeight": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "kind", "node", "agentRadius", "agentHeight" ], "additionalProperties": false }, "collision": { "type": "array", "items": { "type": "object", "properties": { "node": { "$ref": "common.schema.json#/$defs/index" }, "shape": { "enum": [ "mesh", "convex" ] }, "layer": { "const": "static" } }, "required": [ "node", "shape", "layer" ], "additionalProperties": false }, "minItems": 0 }, "audio": { "type": "array", "items": { "type": "object", "properties": { "id": { "$ref": "common.schema.json#/$defs/slug" }, "path": { "allOf": [ { "$ref": "common.schema.json#/$defs/path" }, { "pattern": "\\.(ogg|wav)$", "type": "string" } ] }, "position": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3 }, "radius": { "type": "number", "exclusiveMinimum": 0 }, "gain": { "type": "number", "minimum": 0, "maximum": 1 }, "loop": { "type": "boolean" } }, "required": [ "id", "path", "position", "radius", "gain", "loop" ], "additionalProperties": false }, "minItems": 0 }, "lightmaps": { "type": "array", "items": { "type": "object", "properties": { "material": { "$ref": "common.schema.json#/$defs/index" }, "texture": { "$ref": "common.schema.json#/$defs/index" }, "texCoord": { "const": 1 }, "encoding": { "enum": [ "linear", "srgb" ] }, "intensity": { "type": "number", "minimum": 0 } }, "required": [ "material", "texture", "texCoord", "encoding", "intensity" ], "additionalProperties": false }, "minItems": 0 }, "extensions": { "$ref": "common.schema.json#/$defs/extensions" }, "requiredExtensions": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/id" }, "minItems": 0, "uniqueItems": true } }, "required": [ "formatVersion", "id", "version", "name", "license", "scene", "defaultSpawn", "spawns", "attribution" ], "additionalProperties": false}This is the first published version of this contract.
Manifest fields
| Field | Type | Constraints |
|---|---|---|
formatVersionrequired | "0.1" | |
idrequired | id | |
versionrequired | version | |
namerequired | string | length 1–256 |
description | string | length 0–4096 |
licenserequired | string | length 1–256 |
scenerequired | path & string | |
preview | path | |
defaultSpawnrequired | slug | |
spawnsrequired | object[] | items ≥ 1 |
idrequired | slug | |
poserequired | pose | |
node | index | |
attributionrequired | object[] | items ≥ 1 |
pathrequired | path | "." | |
authorrequired | string | length 1–256 |
licenserequired | string | length 1–256 |
source | string | length 1–2048 · pattern ^https:// |
zones | object[] | items ≥ 0 |
idrequired | slug | |
namerequired | string | length 1–256 |
boundsrequired | object | |
minrequired | number[3] | |
maxrequired | number[3] | |
anchors | object[] | items ≥ 0 |
idrequired | slug | |
poserequired | pose | |
sizerequired | number[2] | each > 0 |
screenTyperequired | id | |
node | index | |
navigation | object | |
kindrequired | "mesh" | |
noderequired | index | |
agentRadiusrequired | number | > 0 |
agentHeightrequired | number | > 0 |
collision | object[] | items ≥ 0 |
noderequired | index | |
shaperequired | "mesh" | "convex" | |
layerrequired | "static" | |
audio | object[] | items ≥ 0 |
idrequired | slug | |
pathrequired | path & string | |
positionrequired | number[3] | |
radiusrequired | number | > 0 |
gainrequired | number | ≥ 0 · ≤ 1 |
looprequired | boolean | |
lightmaps | object[] | items ≥ 0 |
materialrequired | index | |
texturerequired | index | |
texCoordrequired | 1 | |
encodingrequired | "linear" | "srgb" | |
intensityrequired | number | ≥ 0 |
extensions | extensions | |
requiredExtensions | id[] | items ≥ 0 · unique items |
Examples
Offline fixtures from the schema repository, validated by its test suite. They show shape, not a real session or package.
world.json
{ "formatVersion": "0.1", "id": "com.hyprune.observatory", "version": "0.1.0", "name": "Observatory", "license": "CC-BY-4.0", "scene": "scene.gltf", "defaultSpawn": "arrival", "spawns": [ { "id": "arrival", "pose": { "position": [ 0, 1, 0 ], "rotation": [ 0, 0, 0, 1 ] } } ], "attribution": [ { "path": ".", "author": "Hyprune contributors", "license": "CC-BY-4.0" } ], "zones": [ { "id": "work", "name": "Work", "bounds": { "min": [ -4, 0, -4 ], "max": [ 4, 4, 4 ] } } ], "anchors": [ { "id": "desk", "pose": { "position": [ 0, 1.4, -3 ], "rotation": [ 0, 0, 0, 1 ] }, "size": [ 1.6, 0.9 ], "screenType": "com.hyprune.window" } ], "collision": [ { "node": 0, "shape": "mesh", "layer": "static" } ], "navigation": { "kind": "mesh", "node": 1, "agentRadius": 0.3, "agentHeight": 1.8 }, "lightmaps": [ { "material": 0, "texture": 1, "texCoord": 1, "encoding": "linear", "intensity": 1 } ], "audio": [ { "id": "air", "path": "audio/air.ogg", "position": [ 0, 2, 0 ], "radius": 10, "gain": 0.2, "loop": true } ]}Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 c99e88eaa0a6ec4c1efacd6633e23dc6d24b99c33a8a3e0525795b34150c1787.