World manifest 0.8
Schema reference / World manifest / 0.8
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
Loading world.schema.json…Changes since 0.7
Changelog · World 0.8: placed world objects
- World format 0.8 adds
objectAssets(at most 32) andobjects(at most 256). An asset is a package-relative glTF (scene, same extension rules as the world’s scene.gltf; never lightmapped) with optional declarative node animation (at most 16:spinororbitaboutpivot/axisin asset space, orbobalongaxisbyamplitudemetres;period0.5–3600 s, optionalphase), an optional staticcollisionproxy node andlighting.mode(probedefault, orunlit). Nodes are referenced by unique glTF node name.library(id@version) is reserved for shared object libraries and rejected in 0.8. An object places an asset with apose, uniformscale(0.01–100), animationspeed(0–10, default 1),phase(0–1) and an optionalambientRGB override (0–16).validate('world')(from 0.8): unique asset and object ids, known asset references, normalised poses, unit axes, per-type fields (spin/orbit need a pivot and take no amplitude; bob the reverse), one animation per node, collision node not animated, library references rejected.validate('scene', gltf, undefined, '0.8', {world, asset: id})checks an asset’s glTF: extension rules, referenced node names exist exactly once, no animated node inside another animated subtree, the collision node has a mesh and is outside every animated subtree.v0.8/common.schema.jsonis the 0.7 common definitions under the 0.8$id(the directory already held IPC 0.8, which keeps its own references). Everything else is inherited from 0.7 unchanged. Inheritance test included.
Changelog · @hyprune/schema 0.6.0 (2026-10-11)
Publishes IPC 0.20 and world format 0.8 to npm.
Structural diff against 0.7: 1 definition changed. Descriptions and $id changes are ignored.
1 change
- changed
top-level fields- ~
formatVersion"0.7" (required) → "0.8" (required) - +
objectAssetsany of 2[] · items ≤ 32 - +
objectAssets[].idslug (required) - +
objectAssets[].scenepath & string - +
objectAssets[].librarystring · length 3–256 · pattern ^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)*@[0-9A-Za-z.+-]+$ - +
objectAssets[].animationsobject[] · items ≤ 16 - +
objectAssets[].animations[].nodestring (required) · length 1–128 - +
objectAssets[].animations[].type"spin" | "orbit" | "bob" (required) - +
objectAssets[].animations[].axisnumber[3] (required) · each ≥ -1.001 · each ≤ 1.001 - +
objectAssets[].animations[].pivotnumber[3] · each ≥ -10000 · each ≤ 10000 - +
objectAssets[].animations[].amplitudenumber · > 0 · ≤ 10 - +
objectAssets[].animations[].periodnumber (required) · ≥ 0.5 · ≤ 3600 - +
objectAssets[].animations[].phasenumber · ≥ 0 · < 1 - +
objectAssets[].collisionobject - +
objectAssets[].collision.nodestring (required) · length 1–128 - +
objectAssets[].lightingobject - +
objectAssets[].lighting.mode"probe" | "unlit" (required) - +
objectAssets[]|1object - +
objectAssets[]|1.scenestring (required) - +
objectAssets[]|2object - +
objectAssets[]|2.librarystring (required) - +
objectsobject[] · items ≤ 256 - +
objects[].idslug (required) - +
objects[].assetslug (required) - +
objects[].posepose (required) - +
objects[].scalenumber · ≥ 0.01 · ≤ 100 - +
objects[].speednumber · ≥ 0 · ≤ 10 - +
objects[].phasenumber · ≥ 0 · < 1 - +
objects[].ambientnumber[3] · each ≥ 0 · each ≤ 16
- ~
Manifest fields
| Field | Type | Constraints |
|---|---|---|
formatVersionrequired | "0.8" | |
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 | object[] | items ≤ 32 |
idrequired | slug | |
workspaceSlotrequired | string | pattern ^[0-9]{2,4}$ |
primaryAnchorrequired | slug | |
toolAnchorsrequired | slug[] | items ≤ 128 |
dataAnchorsrequired | slug[] | items ≤ 128 |
themerequired | string | length ≤ 256 |
spawnId | slug | |
freePlacementZones | slug[] | items ≤ 32 |
playable | object | requires at least one of volumes, maxFlyHeight |
volumesrequired | any of 2[] | items 1–8 |
when type = "box" | object | |
typerequired | "box" | |
minrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
maxrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
when type = "convex" | object | |
typerequired | "convex" | |
pointsrequired | (number[3])[] | items 4–16 · unique items · each each ≥ -100000 · each each ≤ 100000 |
maxFlyHeight | number | ≥ -100000 · ≤ 100000 |
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 |
playable | object | requires at least one of volumes, maxFlyHeight |
volumes | any of 2[] | items 1–8 |
when type = "box" | object | |
typerequired | "box" | |
minrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
maxrequired | number[3] | each ≥ -100000 · each ≤ 100000 |
when type = "convex" | object | |
typerequired | "convex" | |
pointsrequired | (number[3])[] | items 4–16 · unique items · each each ≥ -100000 · each each ≤ 100000 |
maxFlyHeight | number | ≥ -100000 · ≤ 100000 |
backdrop | object | |
farCardsrequired | integer[] | items ≤ 256 · unique items · each ≥ 0 |
objectAssets | any of 2[] | items ≤ 32 Reusable glTF object assets (RFC-0004 world 0.8). Render-only; optional static collision proxy and declarative node animation. |
idrequired | slug | |
scene | path & string | |
library | string | length 3–256 · pattern ^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)*@[0-9A-Za-z.+-]+$Reserved: a shared object library reference (id@version). Rejected by validators and core in world 0.8. |
animations | object[] | items ≤ 16 |
noderequired | string | length 1–128 |
typerequired | "spin" | "orbit" | "bob" | |
axisrequired | number[3] | each ≥ -1.001 · each ≤ 1.001 |
pivot | number[3] | each ≥ -10000 · each ≤ 10000 |
amplitude | number | > 0 · ≤ 10 |
periodrequired | number | ≥ 0.5 · ≤ 3600 |
phase | number | ≥ 0 · < 1 |
collision | object | |
noderequired | string | length 1–128 |
lighting | object | |
moderequired | "probe" | "unlit" | |
variant 1 | object | |
scenerequired | string | |
variant 2 | object | |
libraryrequired | string | |
objects | object[] | items ≤ 256 Placed instances of objectAssets (RFC-0004 world 0.8). |
idrequired | slug | |
assetrequired | slug | |
poserequired | pose | |
scale | number | ≥ 0.01 · ≤ 100 |
speed | number | ≥ 0 · ≤ 10 |
phase | number | ≥ 0 · < 1 |
ambient | number[3] | each ≥ 0 · each ≤ 16 |
Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 cffb36b8b5605b30b1d0d3054ee62f28ffb6757ac017efd01c7fecf2eeb9cde5.