World manifest 0.4
Schema reference / World manifest / 0.4
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.4/world.schema.json", "title": "Hyprune world 0.4: climbable volumes", "type": "object", "properties": { "formatVersion": { "const": "0.4" }, "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" } }, "climbables": { "type": "array", "maxItems": 128, "items": { "type": "object", "properties": { "id": { "$ref": "common.schema.json#/$defs/slug" }, "type": { "enum": [ "ladder", "rope", "vines", "chain-link" ] }, "bottom": { "type": "array", "items": { "type": "number", "minimum": -10000, "maximum": 10000 }, "minItems": 3, "maxItems": 3 }, "top": { "type": "array", "items": { "type": "number", "minimum": -10000, "maximum": 10000 }, "minItems": 3, "maxItems": 3 }, "facing": { "type": "array", "items": { "type": "number", "minimum": -10000, "maximum": 10000 }, "minItems": 3, "maxItems": 3 }, "width": { "type": "number", "minimum": 0.6, "maximum": 32 }, "depth": { "type": "number", "minimum": 0.1, "maximum": 2 }, "speed": { "type": "number", "minimum": 0.1, "maximum": 8 }, "exits": { "type": "object", "properties": { "top": { "type": "array", "items": { "type": "number", "minimum": -10000, "maximum": 10000 }, "minItems": 3, "maxItems": 3 }, "bottom": { "type": "array", "items": { "type": "number", "minimum": -10000, "maximum": 10000 }, "minItems": 3, "maxItems": 3 } }, "required": [ "top", "bottom" ], "additionalProperties": false } }, "required": [ "id", "type", "bottom", "top", "facing", "width", "depth", "exits" ], "additionalProperties": false } } }, "required": [ "formatVersion", "id", "version", "name", "license", "scene", "defaultSpawn", "spawns", "attribution" ], "additionalProperties": false}Changes since 0.3
Changelog · Climbing: world 0.4 and IPC 0.11
World 0.4 adds validated oriented climbable segments, climb-face normals, feet-position exits, material type and optional speed. Runtime validates capsule clearance against world collision. IPC 0.11 adds version-isolated movement activity, ladder identity and interaction prompt fields. Previous versions stay unchanged. See
test/climbing.test.mjsand RFC-0004/0006.
Structural diff against 0.3: 1 definition changed. Descriptions and $id changes are ignored.
1 change
- changed
top-level fields- ~
formatVersion"0.3" (required) → "0.4" (required) - +
climbablesobject[] · items ≤ 128 - +
climbables[].idslug (required) - +
climbables[].type"ladder" | "rope" | "vines" | "chain-link" (required) - +
climbables[].bottomnumber[3] (required) · each ≥ -10000 · each ≤ 10000 - +
climbables[].topnumber[3] (required) · each ≥ -10000 · each ≤ 10000 - +
climbables[].facingnumber[3] (required) · each ≥ -10000 · each ≤ 10000 - +
climbables[].widthnumber (required) · ≥ 0.6 · ≤ 32 - +
climbables[].depthnumber (required) · ≥ 0.1 · ≤ 2 - +
climbables[].speednumber · ≥ 0.1 · ≤ 8 - +
climbables[].exitsobject (required) - +
climbables[].exits.topnumber[3] (required) · each ≥ -10000 · each ≤ 10000 - +
climbables[].exits.bottomnumber[3] (required) · each ≥ -10000 · each ≤ 10000
- ~
Manifest fields
| Field | Type | Constraints |
|---|---|---|
formatVersionrequired | "0.4" | |
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 |
climbables | object[] | items ≤ 128 |
idrequired | slug | |
typerequired | "ladder" | "rope" | "vines" | "chain-link" | |
bottomrequired | number[3] | each ≥ -10000 · each ≤ 10000 |
toprequired | number[3] | each ≥ -10000 · each ≤ 10000 |
facingrequired | number[3] | each ≥ -10000 · each ≤ 10000 |
widthrequired | number | ≥ 0.6 · ≤ 32 |
depthrequired | number | ≥ 0.1 · ≤ 2 |
speed | number | ≥ 0.1 · ≤ 8 |
exitsrequired | object | |
toprequired | number[3] | each ≥ -10000 · each ≤ 10000 |
bottomrequired | number[3] | each ≥ -10000 · each ≤ 10000 |
Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 a8f56e25b09f4c592cec8d5930b3a22126355dc9fd9c3fb7c07c36420a189b37.