World manifest 0.3
Schema reference / World manifest / 0.3
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.3/world.schema.json", "title": "Hyprune 0.2 world", "type": "object", "properties": { "formatVersion": { "const": "0.3" }, "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" }, "mount": { "$ref": "common.schema.json#/$defs/mount" } }, "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 }, "areas": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/area" }, "maxItems": 32 }, "atmosphere": { "$ref": "common.schema.json#/$defs/atmosphere" }, "placementZones": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/placementZone" }, "maxItems": 32 }, "dataObjects": { "type": "array", "maxItems": 128, "items": { "$ref": "common.schema.json#/$defs/dataObject" } } }, "required": [ "formatVersion", "id", "version", "name", "license", "scene", "defaultSpawn", "spawns", "attribution" ], "additionalProperties": false}Changes since 0.2
Changelog · 0.4.0 (M2)
- World format 0.3: workspace homes, typed mounts/frames/limits, reserved placement volumes, camera-relative atmosphere, HDR bloom/exposure and static sky IBL.
- IPC 0.4: workspace bindings/focus, pull/place/return/recall, durable placement rules, data-object bindings, atmosphere and FOV. Older wire contracts stay frozen.
- Added independent ownership/interaction/limits and version-isolation tests.
Structural diff against 0.2: 1 definition changed. Descriptions and $id changes are ignored.
1 change
- changed
top-level fields- ~
formatVersion"0.2" (required) → "0.3" (required) - +
anchors[].mountmount - +
areasarea[] · items ≤ 32 - +
atmosphereatmosphere - +
placementZonesplacementZone[] · items ≤ 32 - +
dataObjectsdataObject[] · items ≤ 128
- ~
Manifest fields
| Field | Type | Constraints |
|---|---|---|
formatVersionrequired | "0.3" | |
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 | |
mount | mount | |
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 |
areas | area[] | items ≤ 32 |
atmosphere | atmosphere | |
placementZones | placementZone[] | items ≤ 32 |
dataObjects | dataObject[] | items ≤ 128 |
Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 56efe855b91924964b1b26a7363e080b36d7310b0263bfed0bfc605d1e880ad9.