World manifest 0.7
Schema reference / World manifest / 0.7
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.6
Changelog · World 0.7 — 2026-10-09
v0.7/world.schema.json(world.json shape as 0.6,formatVersion: "0.7") andv0.7/common.schema.json(0.6 definitions). Newscenevalidation kind checks a package’sscene.gltfagainst its world format: 0.7 may requireKHR_texture_basisu(KTX2 material textures),EXT_meshopt_compressionandKHR_mesh_quantization, and must list those it uses inextensionsRequired; lightmap textures stay PNG in every v0 format. ExportsatLeast(),worldFormatsandsceneExtensions()so version gates are not hard-coded lists. Inheritance test: every valid 0.6 document is valid as 0.7. IPC is unchanged.
Structural diff against 0.6: 1 definition changed. Descriptions and $id changes are ignored.
1 change
- changed
top-level fields- ~
formatVersion"0.6" (required) → "0.7" (required)
- ~
Manifest fields
| Field | Type | Constraints |
|---|---|---|
formatVersionrequired | "0.7" | |
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 |
Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 12ced20b30304733001717c5d71588a3d695d917cf7ad69dff77c0973fcf625b.