Skip to content

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.

Status
Frozen · latest is 0.11
Published
2026-10-09
Title
“Hyprune world 0.5: ink and visibility areas”
Dialect
JSON Schema 2020-12 · unknown fields rejected unless marked
Raw schemaworld.schema.json · 790 lines · 18 KB
DownloadOpen rawsha256 3495c35b5529…
{
"$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
  • changedtop-level fields
    • ~ formatVersion "0.4" (required) → "0.5" (required)
    • ~ atmosphere atmosphere → object
    • + atmosphere.fog object (required)
    • + atmosphere.fog.color vec3 (required)
    • + atmosphere.fog.density number (required) · ≥ 0 · ≤ 1
    • + atmosphere.fog.heightFalloff number (required) · ≥ 0 · ≤ 10
    • + atmosphere.fog.baseHeight number (required) · ≥ -10000 · ≤ 10000
    • + atmosphere.fog.excludeUnlit boolean (required)
    • + atmosphere.sky object (required)
    • + atmosphere.sky.zenith vec3 (required)
    • + atmosphere.sky.horizon vec3 (required)
    • + atmosphere.sky.ground vec3 (required)
    • + atmosphere.sky.sun object (required)
    • + atmosphere.sky.sun.direction vec3 (required)
    • + atmosphere.sky.sun.color vec3 (required)
    • + atmosphere.sky.sun.intensity number (required) · ≥ 0 · ≤ 10000
    • + atmosphere.sky.sun.angularRadius number (required) · ≥ 0.001 · ≤ 1
    • + atmosphere.environment object
    • + atmosphere.environment.faces path[6] (required)
    • + atmosphere.environment.encoding "srgb" | "linear" (required)
    • + atmosphere.environment.intensity number (required) · ≥ 0 · ≤ 10000
    • + atmosphere.environment.rotation number (required) · ≥ -6.283186 · ≤ 6.283186
    • + atmosphere.environment.maxResolution integer (required) · ≥ 16 · ≤ 512
    • + atmosphere.exposure number (required) · ≥ 0.01 · ≤ 100
    • + atmosphere.toneMapping "aces" | "reinhard" | "linear" (required)
    • + atmosphere.bloom object (required)
    • + atmosphere.bloom.strength number (required) · ≥ 0 · ≤ 2
    • + atmosphere.bloom.threshold number (required) · ≥ 0 · ≤ 100
    • + atmosphere.bloom.radius number (required) · ≥ 1 · ≤ 8
    • + atmosphere.outline object
    • + atmosphere.outline.enabled boolean (required)
    • + atmosphere.outline.colour number[3] (required) · each ≥ 0 · each ≤ 1
    • + atmosphere.outline.widthPx number (required) · ≥ 1 · ≤ 4
    • + atmosphere.outline.depthThreshold number (required) · ≥ 0.0001 · ≤ 1
    • + atmosphere.outline.normalThreshold number (required) · ≥ 0.001 · ≤ 2
    • + visibility object
    • + visibility.areas object[] (required) · items ≤ 256
    • + visibility.areas[].id string (required) · length 1–128
    • + visibility.areas[].bounds object (required)
    • + visibility.areas[].bounds.min number[3] (required) · each ≥ -100000 · each ≤ 100000
    • … 3 more

Manifest fields

FieldTypeConstraints
formatVersionrequired"0.5"
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
areasarea[]items ≤ 32
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

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