Skip to content

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.

Status
Frozen · latest is 0.11
Published
2026-10-11
Title
“Hyprune world 0.8: placed world objects (glTF object assets, instances, declarative node animation); scene assets as 0.7”
Dialect
JSON Schema 2020-12 · unknown fields rejected unless marked
Raw schemaworld.schema.json · 1,261 lines · 31 KB
DownloadOpen rawsha256 cffb36b8b560…
Loading world.schema.json…

Changes since 0.7

Changelog · World 0.8: placed world objects

  • World format 0.8 adds objectAssets (at most 32) and objects (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: spin or orbit about pivot/axis in asset space, or bob along axis by amplitude metres; period 0.5–3600 s, optional phase), an optional static collision proxy node and lighting.mode (probe default, or unlit). 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 a pose, uniform scale (0.01–100), animation speed (0–10, default 1), phase (0–1) and an optional ambient RGB 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.json is 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
  • changedtop-level fields
    • ~ formatVersion "0.7" (required) → "0.8" (required)
    • + objectAssets any of 2[] · items ≤ 32
    • + objectAssets[].id slug (required)
    • + objectAssets[].scene path & string
    • + objectAssets[].library string · length 3–256 · pattern ^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)*@[0-9A-Za-z.+-]+$
    • + objectAssets[].animations object[] · items ≤ 16
    • + objectAssets[].animations[].node string (required) · length 1–128
    • + objectAssets[].animations[].type "spin" | "orbit" | "bob" (required)
    • + objectAssets[].animations[].axis number[3] (required) · each ≥ -1.001 · each ≤ 1.001
    • + objectAssets[].animations[].pivot number[3] · each ≥ -10000 · each ≤ 10000
    • + objectAssets[].animations[].amplitude number · > 0 · ≤ 10
    • + objectAssets[].animations[].period number (required) · ≥ 0.5 · ≤ 3600
    • + objectAssets[].animations[].phase number · ≥ 0 · < 1
    • + objectAssets[].collision object
    • + objectAssets[].collision.node string (required) · length 1–128
    • + objectAssets[].lighting object
    • + objectAssets[].lighting.mode "probe" | "unlit" (required)
    • + objectAssets[]|1 object
    • + objectAssets[]|1.scene string (required)
    • + objectAssets[]|2 object
    • + objectAssets[]|2.library string (required)
    • + objects object[] · items ≤ 256
    • + objects[].id slug (required)
    • + objects[].asset slug (required)
    • + objects[].pose pose (required)
    • + objects[].scale number · ≥ 0.01 · ≤ 100
    • + objects[].speed number · ≥ 0 · ≤ 10
    • + objects[].phase number · ≥ 0 · < 1
    • + objects[].ambient number[3] · each ≥ 0 · each ≤ 16

Manifest fields

FieldTypeConstraints
formatVersionrequired"0.8"
idrequiredid
versionrequiredversion
namerequiredstringlength 1–256
descriptionstringlength 0–4096
licenserequiredstringlength 1–256
scenerequiredpath & string
previewpath
defaultSpawnrequiredslug
spawnsrequiredobject[]items ≥ 1
idrequiredslug
poserequiredpose
nodeindex
attributionrequiredobject[]items ≥ 1
pathrequiredpath | "."
authorrequiredstringlength 1–256
licenserequiredstringlength 1–256
sourcestringlength 1–2048 · pattern ^https://
zonesobject[]items ≥ 0
idrequiredslug
namerequiredstringlength 1–256
boundsrequiredobject
minrequirednumber[3]
maxrequirednumber[3]
anchorsobject[]items ≥ 0
idrequiredslug
poserequiredpose
sizerequirednumber[2]each > 0
screenTyperequiredid
nodeindex
mountmount
navigationobject
kindrequired"mesh"
noderequiredindex
agentRadiusrequirednumber> 0
agentHeightrequirednumber> 0
collisionobject[]items ≥ 0
noderequiredindex
shaperequired"mesh" | "convex"
layerrequired"static"
audioobject[]items ≥ 0
idrequiredslug
pathrequiredpath & string
positionrequirednumber[3]
radiusrequirednumber> 0
gainrequirednumber≥ 0 · ≤ 1
looprequiredboolean
lightmapsobject[]items ≥ 0
materialrequiredindex
texturerequiredindex
texCoordrequired1
encodingrequired"linear" | "srgb"
intensityrequirednumber≥ 0
extensionsextensions
requiredExtensionsid[]items ≥ 0 · unique items
areasobject[]items ≤ 32
idrequiredslug
workspaceSlotrequiredstringpattern ^[0-9]{2,4}$
primaryAnchorrequiredslug
toolAnchorsrequiredslug[]items ≤ 128
dataAnchorsrequiredslug[]items ≤ 128
themerequiredstringlength ≤ 256
spawnIdslug
freePlacementZonesslug[]items ≤ 32
playableobjectrequires at least one of volumes, maxFlyHeight
volumesrequiredany of 2[]items 1–8
when type = "box"object
typerequired"box"
minrequirednumber[3]each ≥ -100000 · each ≤ 100000
maxrequirednumber[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
maxFlyHeightnumber≥ -100000 · ≤ 100000
atmosphereobject
fogrequiredobject
colorrequiredvec3
densityrequirednumber≥ 0 · ≤ 1
heightFalloffrequirednumber≥ 0 · ≤ 10
baseHeightrequirednumber≥ -10000 · ≤ 10000
excludeUnlitrequiredboolean
skyrequiredobject
zenithrequiredvec3
horizonrequiredvec3
groundrequiredvec3
sunrequiredobject
directionrequiredvec3
colorrequiredvec3
intensityrequirednumber≥ 0 · ≤ 10000
angularRadiusrequirednumber≥ 0.001 · ≤ 1
environmentobject
facesrequiredpath[6]
encodingrequired"srgb" | "linear"
intensityrequirednumber≥ 0 · ≤ 10000
rotationrequirednumber≥ -6.283186 · ≤ 6.283186
maxResolutionrequiredinteger≥ 16 · ≤ 512
exposurerequirednumber≥ 0.01 · ≤ 100
toneMappingrequired"aces" | "reinhard" | "linear"
bloomrequiredobject
strengthrequirednumber≥ 0 · ≤ 2
thresholdrequirednumber≥ 0 · ≤ 100
radiusrequirednumber≥ 1 · ≤ 8
outlineobject
enabledrequiredboolean
colourrequirednumber[3]each ≥ 0 · each ≤ 1
widthPxrequirednumber≥ 1 · ≤ 4
depthThresholdrequirednumber≥ 0.0001 · ≤ 1
normalThresholdrequirednumber≥ 0.001 · ≤ 2
placementZonesplacementZone[]items ≤ 32
dataObjectsdataObject[]items ≤ 128
climbablesobject[]items ≤ 128
idrequiredslug
typerequired"ladder" | "rope" | "vines" | "chain-link"
bottomrequirednumber[3]each ≥ -10000 · each ≤ 10000
toprequirednumber[3]each ≥ -10000 · each ≤ 10000
facingrequirednumber[3]each ≥ -10000 · each ≤ 10000
widthrequirednumber≥ 0.6 · ≤ 32
depthrequirednumber≥ 0.1 · ≤ 2
speednumber≥ 0.1 · ≤ 8
exitsrequiredobject
toprequirednumber[3]each ≥ -10000 · each ≤ 10000
bottomrequirednumber[3]each ≥ -10000 · each ≤ 10000
visibilityobject
areasrequiredobject[]items ≤ 256
idrequiredstringlength 1–128
boundsrequiredobject
minrequirednumber[3]each ≥ -100000 · each ≤ 100000
maxrequirednumber[3]each ≥ -100000 · each ≤ 100000
nodesrequiredinteger[]items ≤ 10000 · unique items · each ≥ 0 · each ≤ 9999
visibleFromrequiredstring[]items ≤ 256 · unique items · each length 1–128
playableobjectrequires at least one of volumes, maxFlyHeight
volumesany of 2[]items 1–8
when type = "box"object
typerequired"box"
minrequirednumber[3]each ≥ -100000 · each ≤ 100000
maxrequirednumber[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
maxFlyHeightnumber≥ -100000 · ≤ 100000
backdropobject
farCardsrequiredinteger[]items ≤ 256 · unique items · each ≥ 0
objectAssetsany of 2[]items ≤ 32

Reusable glTF object assets (RFC-0004 world 0.8). Render-only; optional static collision proxy and declarative node animation.

idrequiredslug
scenepath & string
librarystringlength 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.

animationsobject[]items ≤ 16
noderequiredstringlength 1–128
typerequired"spin" | "orbit" | "bob"
axisrequirednumber[3]each ≥ -1.001 · each ≤ 1.001
pivotnumber[3]each ≥ -10000 · each ≤ 10000
amplitudenumber> 0 · ≤ 10
periodrequirednumber≥ 0.5 · ≤ 3600
phasenumber≥ 0 · < 1
collisionobject
noderequiredstringlength 1–128
lightingobject
moderequired"probe" | "unlit"
variant 1object
scenerequiredstring
variant 2object
libraryrequiredstring
objectsobject[]items ≤ 256

Placed instances of objectAssets (RFC-0004 world 0.8).

idrequiredslug
assetrequiredslug
poserequiredpose
scalenumber≥ 0.01 · ≤ 100
speednumber≥ 0 · ≤ 10
phasenumber≥ 0 · < 1
ambientnumber[3]each ≥ 0 · each ≤ 16

Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 cffb36b8b5605b30b1d0d3054ee62f28ffb6757ac017efd01c7fecf2eeb9cde5.