Skip to content

World manifest 0.1

Schema reference / World manifest / 0.1

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-07
Title
“Hyprune v0 world”
Dialect
JSON Schema 2020-12 · unknown fields rejected unless marked
Raw schemaworld.schema.json · 363 lines · 7.7 KB
DownloadOpen rawsha256 c99e88eaa0a6…
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://hyprune.com/schema/v0/world.schema.json",
"title": "Hyprune v0 world",
"type": "object",
"properties": {
"formatVersion": {
"const": "0.1"
},
"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"
}
},
"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
}
},
"required": [
"formatVersion",
"id",
"version",
"name",
"license",
"scene",
"defaultSpawn",
"spawns",
"attribution"
],
"additionalProperties": false
}

This is the first published version of this contract.

Manifest fields

FieldTypeConstraints
formatVersionrequired"0.1"
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
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

Examples

Offline fixtures from the schema repository, validated by its test suite. They show shape, not a real session or package.

world.jsonworld.json · 111 lines · 1.6 KB
{
"formatVersion": "0.1",
"id": "com.hyprune.observatory",
"version": "0.1.0",
"name": "Observatory",
"license": "CC-BY-4.0",
"scene": "scene.gltf",
"defaultSpawn": "arrival",
"spawns": [
{
"id": "arrival",
"pose": {
"position": [
0,
1,
0
],
"rotation": [
0,
0,
0,
1
]
}
}
],
"attribution": [
{
"path": ".",
"author": "Hyprune contributors",
"license": "CC-BY-4.0"
}
],
"zones": [
{
"id": "work",
"name": "Work",
"bounds": {
"min": [
-4,
0,
-4
],
"max": [
4,
4,
4
]
}
}
],
"anchors": [
{
"id": "desk",
"pose": {
"position": [
0,
1.4,
-3
],
"rotation": [
0,
0,
0,
1
]
},
"size": [
1.6,
0.9
],
"screenType": "com.hyprune.window"
}
],
"collision": [
{
"node": 0,
"shape": "mesh",
"layer": "static"
}
],
"navigation": {
"kind": "mesh",
"node": 1,
"agentRadius": 0.3,
"agentHeight": 1.8
},
"lightmaps": [
{
"material": 0,
"texture": 1,
"texCoord": 1,
"encoding": "linear",
"intensity": 1
}
],
"audio": [
{
"id": "air",
"path": "audio/air.ogg",
"position": [
0,
2,
0
],
"radius": 10,
"gain": 0.2,
"loop": true
}
]
}

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