World manifest 0.5
Schema reference / World manifest / 0.5
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.5/world.schema.json", "title": "Hyprune world 0.5: ink and visibility areas", "type": "object", "properties": { "formatVersion": { "const": "0.5" }, "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": { "type": "object", "properties": { "fog": { "type": "object", "properties": { "color": { "$ref": "common.schema.json#/$defs/vec3" }, "density": { "type": "number", "minimum": 0, "maximum": 1 }, "heightFalloff": { "type": "number", "minimum": 0, "maximum": 10 }, "baseHeight": { "type": "number", "minimum": -10000, "maximum": 10000 }, "excludeUnlit": { "type": "boolean" } }, "required": [ "color", "density", "heightFalloff", "baseHeight", "excludeUnlit" ], "additionalProperties": false }, "sky": { "type": "object", "properties": { "zenith": { "$ref": "common.schema.json#/$defs/vec3" }, "horizon": { "$ref": "common.schema.json#/$defs/vec3" }, "ground": { "$ref": "common.schema.json#/$defs/vec3" }, "sun": { "type": "object", "properties": { "direction": { "$ref": "common.schema.json#/$defs/vec3" }, "color": { "$ref": "common.schema.json#/$defs/vec3" }, "intensity": { "type": "number", "minimum": 0, "maximum": 10000 }, "angularRadius": { "type": "number", "minimum": 0.001, "maximum": 1 } }, "required": [ "direction", "color", "intensity", "angularRadius" ], "additionalProperties": false } }, "required": [ "zenith", "horizon", "ground", "sun" ], "additionalProperties": false }, "environment": { "type": "object", "properties": { "faces": { "type": "array", "items": { "$ref": "common.schema.json#/$defs/path" }, "minItems": 6, "maxItems": 6 }, "encoding": { "enum": [ "srgb", "linear" ] }, "intensity": { "type": "number", "minimum": 0, "maximum": 10000 }, "rotation": { "type": "number", "minimum": -6.283186, "maximum": 6.283186 }, "maxResolution": { "type": "integer", "minimum": 16, "maximum": 512 } }, "required": [ "faces", "encoding", "intensity", "rotation", "maxResolution" ], "additionalProperties": false }, "exposure": { "type": "number", "minimum": 0.01, "maximum": 100 }, "toneMapping": { "enum": [ "aces", "reinhard", "linear" ] }, "bloom": { "type": "object", "properties": { "strength": { "type": "number", "minimum": 0, "maximum": 2 }, "threshold": { "type": "number", "minimum": 0, "maximum": 100 }, "radius": { "type": "number", "minimum": 1, "maximum": 8 } }, "required": [ "strength", "threshold", "radius" ], "additionalProperties": false }, "outline": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "colour": { "type": "array", "items": { "type": "number", "minimum": 0, "maximum": 1 }, "minItems": 3, "maxItems": 3 }, "widthPx": { "type": "number", "minimum": 1, "maximum": 4 }, "depthThreshold": { "type": "number", "minimum": 0.0001, "maximum": 1 }, "normalThreshold": { "type": "number", "minimum": 0.001, "maximum": 2 } }, "required": [ "enabled", "colour", "widthPx", "depthThreshold", "normalThreshold" ], "additionalProperties": false } }, "required": [ "fog", "sky", "exposure", "toneMapping", "bloom" ], "additionalProperties": false }, "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 } }, "visibility": { "type": "object", "properties": { "areas": { "type": "array", "maxItems": 256, "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "bounds": { "type": "object", "properties": { "min": { "type": "array", "items": { "type": "number", "minimum": -100000, "maximum": 100000 }, "minItems": 3, "maxItems": 3 }, "max": { "type": "array", "items": { "type": "number", "minimum": -100000, "maximum": 100000 }, "minItems": 3, "maxItems": 3 } }, "required": [ "min", "max" ], "additionalProperties": false }, "nodes": { "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 9999 }, "maxItems": 10000, "uniqueItems": true }, "visibleFrom": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "maxItems": 256, "uniqueItems": true } }, "required": [ "id", "bounds", "nodes", "visibleFrom" ], "additionalProperties": false } } }, "required": [ "areas" ], "additionalProperties": false } }, "required": [ "formatVersion", "id", "version", "name", "license", "scene", "defaultSpawn", "spawns", "attribution" ], "additionalProperties": false}Changes since 0.4
Structural diff against 0.4: 1 definition changed. Descriptions and $id changes are ignored.
1 change
- changed
top-level fields- ~
formatVersion"0.4" (required) → "0.5" (required) - ~
atmosphereatmosphere → object - +
atmosphere.fogobject (required) - +
atmosphere.fog.colorvec3 (required) - +
atmosphere.fog.densitynumber (required) · ≥ 0 · ≤ 1 - +
atmosphere.fog.heightFalloffnumber (required) · ≥ 0 · ≤ 10 - +
atmosphere.fog.baseHeightnumber (required) · ≥ -10000 · ≤ 10000 - +
atmosphere.fog.excludeUnlitboolean (required) - +
atmosphere.skyobject (required) - +
atmosphere.sky.zenithvec3 (required) - +
atmosphere.sky.horizonvec3 (required) - +
atmosphere.sky.groundvec3 (required) - +
atmosphere.sky.sunobject (required) - +
atmosphere.sky.sun.directionvec3 (required) - +
atmosphere.sky.sun.colorvec3 (required) - +
atmosphere.sky.sun.intensitynumber (required) · ≥ 0 · ≤ 10000 - +
atmosphere.sky.sun.angularRadiusnumber (required) · ≥ 0.001 · ≤ 1 - +
atmosphere.environmentobject - +
atmosphere.environment.facespath[6] (required) - +
atmosphere.environment.encoding"srgb" | "linear" (required) - +
atmosphere.environment.intensitynumber (required) · ≥ 0 · ≤ 10000 - +
atmosphere.environment.rotationnumber (required) · ≥ -6.283186 · ≤ 6.283186 - +
atmosphere.environment.maxResolutioninteger (required) · ≥ 16 · ≤ 512 - +
atmosphere.exposurenumber (required) · ≥ 0.01 · ≤ 100 - +
atmosphere.toneMapping"aces" | "reinhard" | "linear" (required) - +
atmosphere.bloomobject (required) - +
atmosphere.bloom.strengthnumber (required) · ≥ 0 · ≤ 2 - +
atmosphere.bloom.thresholdnumber (required) · ≥ 0 · ≤ 100 - +
atmosphere.bloom.radiusnumber (required) · ≥ 1 · ≤ 8 - +
atmosphere.outlineobject - +
atmosphere.outline.enabledboolean (required) - +
atmosphere.outline.colournumber[3] (required) · each ≥ 0 · each ≤ 1 - +
atmosphere.outline.widthPxnumber (required) · ≥ 1 · ≤ 4 - +
atmosphere.outline.depthThresholdnumber (required) · ≥ 0.0001 · ≤ 1 - +
atmosphere.outline.normalThresholdnumber (required) · ≥ 0.001 · ≤ 2 - +
visibilityobject - +
visibility.areasobject[] (required) · items ≤ 256 - +
visibility.areas[].idstring (required) · length 1–128 - +
visibility.areas[].boundsobject (required) - +
visibility.areas[].bounds.minnumber[3] (required) · each ≥ -100000 · each ≤ 100000 - … 3 more
- ~
Manifest fields
| Field | Type | Constraints |
|---|---|---|
formatVersionrequired | "0.5" | |
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 | object | |
fogrequired | object | |
colorrequired | vec3 | |
densityrequired | number | ≥ 0 · ≤ 1 |
heightFalloffrequired | number | ≥ 0 · ≤ 10 |
baseHeightrequired | number | ≥ -10000 · ≤ 10000 |
excludeUnlitrequired | boolean | |
skyrequired | object | |
zenithrequired | vec3 | |
horizonrequired | vec3 | |
groundrequired | vec3 | |
sunrequired | object | |
directionrequired | vec3 | |
colorrequired | vec3 | |
intensityrequired | number | ≥ 0 · ≤ 10000 |
angularRadiusrequired | number | ≥ 0.001 · ≤ 1 |
environment | object | |
facesrequired | path[6] | |
encodingrequired | "srgb" | "linear" | |
intensityrequired | number | ≥ 0 · ≤ 10000 |
rotationrequired | number | ≥ -6.283186 · ≤ 6.283186 |
maxResolutionrequired | integer | ≥ 16 · ≤ 512 |
exposurerequired | number | ≥ 0.01 · ≤ 100 |
toneMappingrequired | "aces" | "reinhard" | "linear" | |
bloomrequired | object | |
strengthrequired | number | ≥ 0 · ≤ 2 |
thresholdrequired | number | ≥ 0 · ≤ 100 |
radiusrequired | number | ≥ 1 · ≤ 8 |
outline | object | |
enabledrequired | boolean | |
colourrequired | number[3] | each ≥ 0 · each ≤ 1 |
widthPxrequired | number | ≥ 1 · ≤ 4 |
depthThresholdrequired | number | ≥ 0.0001 · ≤ 1 |
normalThresholdrequired | number | ≥ 0.001 · ≤ 2 |
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 |
visibility | object | |
areasrequired | object[] | items ≤ 256 |
idrequired | string | length 1–128 |
boundsrequired | object | |
minrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
maxrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
nodesrequired | integer[] | items ≤ 10000 · unique items · each ≥ 0 · each ≤ 9999 |
visibleFromrequired | string[] | items ≤ 256 · unique items · each length 1–128 |
Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 3495c35b55299cd505627af96b0d0be925f623c0c2e78426db125e8bc6c21498.