Schema reference
Hyprune’s machine-readable contracts live in hyprune/schema as JSON Schema 2020-12. This reference is generated from those exact files at build time: each version has a readable field reference, the changes since the previous version, the RFC sections that define it and the raw JSON to view or download.
Contracts
How versions work
- World format and IPC protocol versions are independent. A package declares
formatVersion; a client negotiates IPC insession.hello. Today core speaks IPC 0.1 through 0.28 and loads world formats 0.1 through 0.11. - Each version lives in its own directory and never changes after publication. Raw files keep the URL in their
$id, for examplehttps://hyprune.com/schema/v0.28/ipc.schema.json, so editors and tools can resolve them. - Old versions stay supported. Core accepts every published world format and negotiates any published IPC version; features are gated by comparing version numbers, never against a hard-coded list, and the schema repo’s inheritance tests keep each revision a superset of the one it extends.
- RFCs are normative for meaning; the schemas pin shape. Each version page links the RFC amendment that introduced it.
Validating your files
Map your editor’s JSON schema setting to a raw URL (for example https://hyprune.com/schema/v0.11/world.schema.json for world.json) for completion and inline errors; manifests reject unknown keys, so don’t add a $schema field to the file itself. The hyprune world validate command in the SDK and the schema repository’s Node validator adds semantic checks that JSON Schema can’t express: duplicate IDs, normalised quaternions, AABB ordering, SPDX licences and per-format glTF extension rules.
Schema changelog
v0 / 0.1.0 — 2026-10-07 (proposed)
Initial JSON Schema 2020-12 family: world format 0.1, IPC 0.1, extension manifest/API 0.1, screen descriptor 0.1. Includes every core method’s request and result plus notifications, offline examples and a Node validator. Identifiers are reserved for these contracts; incompatible changes require a new wire/format identifier and migration notes. No runtime compatibility is claimed yet.
0.2.0 — 2026-10-07
Adds frozen v0.2/ schemas for IPC 0.2 and world format 0.2; v0/ stays unchanged. The validator accepts an optional fourth version argument (default 0.1); CLI accepts [response-method|-] [contract-version].
IPC adds camera get/set, waypoint/route, travel, autodrive, ui.open/close, data.publish/remove and presentation notifications. location and integrations are revisioned state keys. Publishing requires its own capability; scalar values, TTL, sequence and ownership are specified by RFC-0003. World 0.2 has the same manifest shape, with RFC-0004’s sampler/transform/PBR material semantics. No mock-only protocol is accepted.
M1 shell reconciliation adds stable transition IDs, output identity, monotonic timestamps and indeterminate loading/failed phases. World-load destinations remain distinct from point/zone navigation targets.
0.3.0 — first real session
Frozen IPC 0.3 adds verified shell Wayland-child binding, workspace activation, revisioned safe inline map/metadata, selected-output descriptor and core-projected markers. 0.1/0.2 and world formats remain frozen. New positive/negative tests cover version isolation, reserved parameters, PID/workspace bounds and marker clipping.
0.4.0 (M2)
- World format 0.3: workspace homes, typed mounts/frames/limits, reserved placement volumes, camera-relative atmosphere, HDR bloom/exposure and static sky IBL.
- IPC 0.4: workspace bindings/focus, pull/place/return/recall, durable placement rules, data-object bindings, atmosphere and FOV. Older wire contracts stay frozen.
- Added independent ownership/interaction/limits and version-isolation tests.
0.5.0 (M3A)
Frozen IPC 0.5 adds revisioned interaction mode/tool state, workspace app metadata, and custom surface pose/size placement rules. All prior schemas stay unchanged; world format remains 0.3. Tests cover exact version isolation, closed objects, bounded app/tool collections and complete custom placement records.
IPC 0.6 (M3B): independent input keymap v2, three variants per action, core-owned validated persistence and lease-bound capture; closed keymap/editor state, per-area paths and object transforms, scope FOV down to 3 degrees, Map opening intent. Older contracts remain byte-identical.
IPC 0.7 publishes the exact shell graphics handoff: discoverable presets/effects,
validated sparse graphics.set, effective settings and asynchronous GPU timings.
IPC 0.8 adds keymap.holds (monotonic start time and configured duration) for
shell-owned hold animation. Protocols through 0.7 retain their exact shapes;
world format remains 0.3. No compositor config reload is involved.
Climbing: world 0.4 and IPC 0.11
World 0.4 adds validated oriented climbable segments, climb-face normals,
feet-position exits, material type and optional speed. Runtime validates capsule
clearance against world collision. IPC 0.11 adds version-isolated movement
activity, ladder identity and interaction prompt fields. Previous versions stay
unchanged. See test/climbing.test.mjs and RFC-0004/0006.
IPC 0.12 — deterministic input and camera recordings
Extends frozen IPC 0.11 (climbing) with input.control-gated recording.start/stop/ mark/status and replay.start/stop/status, bounded assertion specs, and the unbound record.toggle action in every input mode. Older keymaps are projected without that action. Runtime records are private, versioned JSONL, with app keystrokes masked by default. Replay uses a fixed 60 Hz clock; camera-only replay never forwards input. Existing 0.11 movement activity remains inherited.
IPC 0.13 and world 0.5 — generic authoring and rendering controls
- Capability-gated photo-camera hold with normalized quaternion, 5–140° vertical FOV, NDC lens shift and fixed render scale; camera.get reports actual lens state.
- Optional authored depth/normal ink style and Performance override/cost.
- Explicit visibility areas with bounds, scene-node subtrees and visibleFrom lists. Unassigned geometry and cameras outside areas remain visible.
- Prior world and IPC schemas are unchanged; positive/negative tests cover the new bounds, links, ownership and closed fields.
IPC 0.15 — tool slots, pocket queue and content sizing
Adds generic tool declarations, bounded pocket/client feedback, canonical shared Primary/Secondary/Alternate/Cycle bindings and optional persistent placement content dimensions. Earlier IPC schemas stay byte-for-byte frozen. World format is unchanged (0.5).
World 0.7 — 2026-10-09
v0.7/world.schema.json (world.json shape as 0.6, formatVersion: "0.7") and
v0.7/common.schema.json (0.6 definitions). New scene validation kind checks a
package’s scene.gltf against its world format: 0.7 may require
KHR_texture_basisu (KTX2 material textures), EXT_meshopt_compression and
KHR_mesh_quantization, and must list those it uses in extensionsRequired;
lightmap textures stay PNG in every v0 format. Exports atLeast(),
worldFormats and sceneExtensions() so version gates are not hard-coded lists.
Inheritance test: every valid 0.6 document is valid as 0.7. IPC is unchanged.
IPC 0.16 — 2026-10-10
v0.16/ipc.schema.json: graphics upscaler setting (fsr1 | bilinear |
null) in config, effective values, overrides, presets and graphics.set
patches; session.hello reports 0.16. Inheritance test: every 0.15
definition exists in 0.16 and the graphics properties differ only by the new key.
IPC 0.17: debug capture notes
capture.annotate {captureId, note}(shell.control): writes an optional note (0..1000 code points, no control characters) into a debug capture’s JSON and the captures index. Result{revision}.capture.taken {captureId, timestampMs, mode}notification, sent to 0.17 shells when U (or the mode’s capture binding) snapshots the world, before the files are written.- Everything else is inherited from 0.16 unchanged.
IPC 0.18: device-scaled offload power cap and offload device selection
offload_power_cap_wingraphicsConfig/graphicsPatchis a number 20–1000 ornull(was 20–100).null, the new default, is automatic: the battery profile ceiling with a battery, otherwise 75 % of the offload GPU’s enforced power limit (80 W when the limit is unknown).- New
offload_device:"auto"(default) or the lowercase PCI address (domain:bus:device.function, e.g.0000:65:00.0) of the GPU that runs the offload renderer. performance(graphics.get/set) gains requiredcapSource(profile|device|configured|fallback) anddevice(nullor{pci, node, name, enforcedLimitW, selection, drivesCompositor}).profileis unchanged; systems without a battery reportfull-ac.session.helloreports0.18. Everything else is inherited from 0.17 unchanged. Inheritance test: every 0.17 definition is identical except the graphics properties (only the two offload keys differ),performance(only the two new keys) and the hello protocol constant.
IPC 0.19: player settings, view bob and reticle
player.get {}(state.read) andplayer.set {patch}(movement.control) returnplayerSettings {config, defaults, overrides, options, ranges, path, error}.playerConfigkeys:walk_speed,run_speed,view_bob(off|subtle|normal),reticle_style,reticle_size,reticle_thickness,reticle_gap,reticle_opacity,reticle_outline,reticle_colour("theme"or RGB),reticle_dynamic,reach_grab,reach_mount,reach_placement.playerPatchtakes any subset (at least one key);nullremoves a persisted override.overridesusesplayerOverrides(the same keys, never null, may be empty).graphicsfovaccepts 30..120 (was 30..110) in config and patches.overlayStylegainsreticleColor,validColorandinvalidColor(RGB 0..1; required in the result, optional in the params patch).interaction.reticle {state, action}(required): what the reticle shows (hidden|neutral|typing|target|valid|out_of_range|invalid|holding) and the action it would take (""|click|grab|pocket|place|mount|select|path|drop).- Everything else is inherited from 0.18 unchanged, including the offload cap
and device keys;
session.helloreports0.19.
IPC 0.20: pocket actions and blueprint map levels
surface.pocket {surfaceId}andsurface.unpocket {surfaceId}(surface.control). Pocket: the window leaves the world for the Placement queue, its placement kept; idempotent. Unpocket: placed at a free spot in front of the player (placed: true) or left in the pocket, selected for the Placement tool (placed: false). Results{revision}/{revision, placed}.map.levels(optional, 1..6):{id, name, minY, maxY, svg, sha256}per blueprint level, sorted byminY, in the frame of the map (worldToMap).- New
extensions/blueprint.schema.json: thecom.hyprune.blueprint0.1 world extension (levels with package-relative SVG paths; byte budgets, ordering and theclassvocabulary are stated in its description and enforced by consumers). - Everything else is inherited from 0.19 unchanged;
session.helloreports0.20and lists the two methods. Inheritance test included.
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.
@hyprune/schema 0.6.0 (2026-10-11)
Publishes IPC 0.20 and world format 0.8 to npm.
Object manifests 0.9, libraries and the library release record (RFC-0011)
New contract files; no IPC or world format change (world formats stay 0.1–0.8).
Object manifests use the world format numbering: a world may use objects whose
formatVersion is at most its own.
v0.9/object.schema.json(object.json):id(slug, equals the directory name), SemVerversion,name,category,tags, a directory-relativescene,license+attribution, rest-posebounds, optionalthumbnailandlighting,traitsand optionalslots. Traits:decorative(0.8 node animations),collidable(0.8 proxy),movable(surfaces,upright,scale),character(measuredclipswithwalkandidle,height,radius,accent, asset-levelsay/panelinteractions) andseat(anchors,capacity).mover,machine,mountandinteractiveare reserved and rejected with a reason. Slotsstates,labels,spawnsandeffects(at most 8 each) are validated and inert.v0.9/library.schema.json(library.json): reverse-domainid,version,name,license+attributionand 1–256 listedobjects.v0.9/library-releases.schema.json: the meta repository’slibraries/releases.json, one record perid@version(id,version,formatVersion,url,sha256,nixHash,published).- Draft
v0.10/object.schema.jsonandv0.10/library.schema.json: 0.9 plus themovertrait, RFC-0013’smachinetrait (typedinputswithrepeat,drivesin the mapping language,primary,positions,recipes) and the slot additions (labelsfont/align/colour/plate,spawnstrack/items/maxRate,effectskind/colour/durationMs, newtracks,stacks,toggles,ports). It may change until world format 0.10 is defined. validate('object', manifest, undefined, format?, options): trait combinations, origin conventions (floor, wall and ceiling within 1 cm; a character’s rest-pose feet within 5 cm), slot ids, poses inside the bounds grown by 0.5 m, palettes, seat anchors, track points and arcs, stack layouts, machine input references, drive targets and output domains. Withoptions.gltf: the format’s glTF extension rules, node names (unique, in the scene; the proxy may sit outside it), the 0.8 animation and proxy rules, states-slot materials and nodes (one slot each),KHR_materials_variantsmappings (variant names of a states slot are palette ids), character skins, clips andextras.speed(2%), triangle budgets (50,000; characters 16,000; items 2,000; proxy 2,000) and bounds (exact for axis-aligned meshes, else a containing box).options.files,thumbnail,measuredanddirectoryadd the directory limits, attribution coverage, the 256 x 256 thumbnail, the 1 cm bounds check and texture and GPU budgets. Results carrywarnings.validate('library', manifest, undefined, format?, {objects, files})andvalidate('library-releases', record).objectFormatsandobjectLimitsare exported. The CLI acceptsobject(with an optional glTF/GLB),libraryandlibrary-releases.
IPC 0.21: markers, personal quests and focus sessions
- New grant
quest.control(hello capabilities): every quest and focus mutation andguidance.set. - Required state keys:
markers {reveal, persistent, calm, coreDraw, list}(revealholdMs0 = toggle or 1000..15000,fadeMs0..600; at most 64 markers with tier 1..4, labels up to 48 characters, one target of position, zone, area, place or workspace),quests {enabled, tracked, active[<=16], counts, world: null}andfocus {state, pausedState, sessionId, phaseStartedAtMs, phaseEndsAtMs, phaseMs, remainingMs, creditedMs, crediting, cycle, cycles, breakKind, countMode, target, calm}. Times are monotonic ms. - Methods:
markers.reveal {durationMs?}(shell.control);guidance.get,guidance.set {patch}returning{config, defaults, overrides, ranges, options, path, error}over 21 flat dotted keys;quests.list {states?, sources?},quests.get {questRef},quests.track {questRef|null},quests.accept/abandon/resume/delete {questRef},quests.create {quest}({revision, questRef}),quests.update {questRef, quest},quests.mark {questRef, stepId, objectiveId};focus.start {target?, questRef?, objectiveId?, overrides?}({revision, sessionId}),focus.pause/resume/skip/stop {},focus.history {days?}(at most 512 intervals). Personal quests: 1..16 steps, 1..8manual,reachorfocusobjectives per step. - Events:
quest.progressandfocus.phase(focusSessionId; every event carries the IPCsessionIdandrevision). inputConfigworld mode gainsmarkers.reveal;overlayStylegains requiredquestColor(optional in the patch);spatial.projectionmarkers gain optionalmarkerId.- File schemas:
v0.21/quests-personal.schema.json,v0.21/guidance.schema.json,v0.21/focus-history.schema.json. - Everything else is inherited from 0.20 unchanged;
session.helloreports0.21. Inheritance test included.
IPC 0.22: object catalog, user placements and libraries (RFC-0011 P1)
- New grant
objects.control(hello capabilities): every overlay change and library install/remove. - Required state key
objects {catalogRevision, instances[<=512], pocket[<=16], usage, limits}. An instance is{id, source (authored|user), ref, name, areaId, pose, scale, state (active|hidden|missing|blocked|loading|suspended), movable, locked, rule, path, activity, seat};path,activityandseatare always null until P2.usage/limitscount this world’s user placements (placements, assets, triangles, gpuBytes, collisionTriangles). - Methods:
objects.catalog {}({revision, entries[<=1024]}; an entry carries ref, source, id, version, formatVersion, name, description, category, tags, traits, surfaces, scale range, bounds, triangles, gpuBytes, collisionTriangles, an absolute thumbnail path, license, library, other versions, state, placeable, reason and up to 8 errors);objects.pocket {ref}({revision, itemId});objects.place {ref, pose?, scale?}({revision, id});objects.transform {id, pose, scale?};objects.remove {id}|{all:true};objects.hide {id, hidden};objects.reset {id}|{all:true};objects.configure {id, patch:{locked}};libraries.list {};libraries.install {archive, sha256}({revision, id, version});libraries.remove {id, version}. Refs arepackage/<asset>,library/<id>@<semver>/<object>oruser/<object>. editor.selectedKindgainsnode;editor.submodegainsuniversal;editor.unplacedgainsobjects(pocket items,countup to 32); new requirededitor.gizmo {space, pivot, snap}.- Error
datamay carryrule(the placement rule or limit that refused a method). - Everything else is inherited from 0.21 unchanged;
session.helloreports0.22. Inheritance test included.
@hyprune/schema 0.7.0 (2026-10-12)
Publishes IPC 0.21 (markers, personal quests, focus sessions) and IPC 0.22 (object catalog, user placements, libraries), plus the object manifest (object.json 0.9 and the 0.10 draft), library and library release-record schemas.
World 0.9: characters, paths, seats and keepClear (RFC-0011 P2)
objectAssets[](at most 32, ids unique) take exactly one source: inline{id, scene, animations?, collision?, lighting?, traits?, slots?}(the 0.8 asset plus object.json 0.9traitsandslots;decorative,collidable,movable,characterandseatare allowed,mover,mount,machineandinteractiverejected),dir {id, dir}(a package directory holdingobject.json, object format at most the world’s) orlibrary {id, library, object}(libraryis<reverse-domain id>@<semver>,objecta slug).animationsis shorthand fortraits.decorative.animationsandcollisionfortraits.collidable; giving both forms of one is invalid.objects[]gainpath(aroutepath; replacespose),reverse(only withpath),seat(aseats[]id,<objectId>/<anchorId>or<objectId>; characters without a path),accent(linear RGB 0..1),interactions(1..8, replacing the asset’s list) andlocked(movable assets).poseis required unlesspathis set and forbidden with it. A character’sscalemust be 1; at most 16 character instances and 8 per path.- Instance interactions
{id, label (1..32), prompt? (1..64), action}withsay {lines[1..8]},waypoint {target: {zoneId}|{position}|{anchor}|{object}},guide {path}(a route) orpanel {panel}.travelandquestare reserved and rejected. Asset-level interactions staysay/panel. paths[](at most 64, 1,024 points in total):{id, name?, use? (route|track|generic, default generic), closed?, points[2..256] {position, type: line|curve|arc}, speed? (0.1..30), stops?[<=32]}. A stop is{point, seconds? (0.5..600), clip? (look_around|wave|nod|idle_fidget), face? ({position}|{anchor}|{object}), seat?}with at most one of clip, face and seat, one stop per point and the point below the point count. Track stops take onlypointandseconds; generic paths have no stops. Anarcneeds a horizontal chord of at least 0.1 m.seats[](at most 64):{id, pose, height (0.2..1), use? (["sit"]), approach? (0.3..2)}.keepClear[](at most 64):{id, min, max}, min below max on every axis.validate('world', manifest, undefined, '0.9', {assets})adds unique ids, asset, path, seat, waypoint and face references, route-only bindings, character-only and movable-only fields, pose/path exclusivity, normalised seat poses, arc chords, the point total, keepClear ordering and the character limits.assetsmaps a dir or library asset id to its parsedobject.json, so its traits are checked like an inline asset’s; without it those checks skip the asset. Reserved traits and actions are reported with a plain reason.worldLimitsexports the limits.validate('scene', gltf, undefined, '0.9', {world, asset})reads an inline asset’s animations and proxy from either form and checks an inline character’s skin and clips; dir and library assets are checked as objects.v0.9/common.schema.jsonis the 0.8 common definitions under the 0.9$id(the directory’s IPC, input, object and library schemas are untouched).examples/world-npcs.jsonis a synthetic 0.9 manifest. Everything else is inherited from 0.8 unchanged. Inheritance test included.
IPC 0.23: characters, paths and interactions (RFC-0011 P2)
- Required state key
npcs {motion (auto|always|still|off), state (none|animating|paused|still|off), reason (null or up to 64 characters, e.g. battery), usage {authored, user}, limits {authored (<=16), user (<=8)}, drawing, aimed, interaction}.drawingis null or{pathId, use, spawn: null|{ref}, bind: null|objectId}(apaths.drawin progress);aimedis null or{objectId, name, prompt, interactions[<=8] {id, label, type}};interactionis null or{objectId, interactionId|null, type (choose|say|waypoint|guide|panel), label, choices[<=8] {id, label}, line|null, lineIndex, lineCount, panel|null}. objects.instances[]gain requiredcharacter(boolean) andaccent(null or linear RGB);pathis null or a qualified path ref (package/<id>,user/<id>),activitynull oridle|walking|running|stopped|sitting|guiding|interacting|suspended,seatnull or a seat ref (up to 192 characters).editor.paths[]gain requireduse(route|track|generic),name(string|null),speed(number|null) andstops(at most 32, the world 0.9 stop shape).interaction.reticle.actiongainsinteract.graphicsConfigandgraphicsPatchgainnpc_motion(auto,always,still,off).- Methods:
npcs.spawn {ref, path?, pose?, phase?, speed? (0.25..2), accent?, reverse?}({revision, id}; path and pose exclusive, reverse needs a path);npcs.bind {id, path?, pose?, phase?, speed?, accent?, reverse?}(at least one setting);npcs.disable {id, disabled};npcs.remove {id}|{all:true};paths.list {}({paths[<=192]}:{ref, source (package|user), id, name, use, closed, points, speed, stops, walkable (null for non-routes), problems[<=8], bound[<=8]});paths.set {path: {id?, name?, use, closed, points[2..256], speed?, stops?}}({revision, id});paths.remove {id, unbind?};paths.draw {use?, name?, spawn? {ref, phase?, speed?, accent?}, bind?}({revision, id}; spawn and bind exclusive);paths.finish {}({revision, id|null, bound|null});interaction.choose {objectId, interactionId|null}. Path params take a qualified ref or a bare id (package/<id>);paths.set/remove/draw/finishids are user path ids. Grants:npcs.*andpaths.set/remove/draw/finishneedobjects.control,paths.listneedsstate.read,interaction.chooseneedsworld.control. - Everything else is inherited from 0.22 unchanged (no new grant or event);
session.helloreports0.23and lists the ten methods. Inheritance test included.
@hyprune/schema 0.8.0 (2026-10-12)
Publishes IPC 0.23 and world format 0.9: characters and NPC instances, authored paths (route/track/generic) with stops, seats, keepClear volumes and NPC interactions.
Unreleased: object manifest 0.10 draft additions
Draft only; no version changes. v0.10/object.schema.json and the validator:
- Mappings take an
averagemodifier{windowS? (1–3600, default 60), override?}: the running average of a numeric value, alone or underscale,thresholds,casesorformat; never withbecomesorcounter. The validator requires anintornumberinput, and in drives anoverridethat names another non-event input of the machine (recipes take no override). A direct average of anintis fractional, so counts need a rounded scale. - New slot kind
levels(at most 8):{id, node, mode: fill|slide, axis? (unit vector, default [0, 1, 0]), length (> 0, ≤ 10), surface? (fill only), settle?: ease|spring}and drive targetlevel:<id>(outputs 0–1). With the glTF:nodeandsurfaceexist in the scene, the surface is not inside the fill node’s subtree, no node is moved by two slots, and the collision proxy is never moved. stacks:capup to 100 (was 64) and an optionalrate(copies per second, 0–1000).layout.spacingcomponents may be negative (−10 to 10 m; copies fill from the node towards the sign) and must be non-zero where that axis’s grid is above 1.
IPC 0.24: machine inputs in the catalog and live machine state (RFC-0013)
objects.catalogentries gain requiredmachine: null for an entry without the machine trait, else{primary: input id|null, inputs[1..16]}. Each input is the object 0.10 declaration as authored:{id, type (enum|int|number|bool| text|event|items), label, explain, default?, values? (enum), min?/max? (int, number), maxLength? (text), repeat? (2–16, not expanded), states? (items)}.- Required state key
live {instances[<=64]}, published on change and never per frame. An instance is{id, asset, ref|null, source|null (the source every bound input reads, null when they differ), status (ok|error|null, the source's _status), error (<=256|null, its _error), stale, inputs};inputsmaps up to 16 input ids, repeated inputs expanded (health.1), to{source|null, key|null, value, raw, condition (fresh|stale|missing|error), publishedAt}. Values are scalars (strings <=256) or null;publishedAtis the wall-clock Unix ms of the publication core holds, null when missing. - Everything else is inherited from 0.23 unchanged (no new method, grant or
event);
session.helloreports0.24. Inheritance test included.
@hyprune/schema 0.9.0 (2026-10-13)
Publishes IPC 0.24: objects.catalog entries carry a placed machine’s declared inputs (machine), and a new live state key reports each placed machine’s source, status and per-input values (published only on change). Inherited from 0.23 otherwise; no new grant. Also the object 0.10 draft additions for gauges: the average mapping modifier, levels slots (fill/slide with spring) and stack rate, cap 100 and signed spacing.
IPC 0.25 (draft): companions (RFC-0010 companions amendment)
- Methods (grant
objects.control):companion.set {ref}(a companion-capable library or user catalog ref),companion.clear {}andcompanion.mode {mode: follow|stay}; each returns{revision}. Existing methods take the reserved object idcompanion:npcs.bind(a route or a standing spot),paths.draw {bind}andinteraction.choose. No new grant, no new event. - Required state key
companion {ref|null, name|null (<=32), state (none|loading|unavailable|active|waiting|hidden), reason|null (<=64), mode (follow|stay|route), path|null (qualified path ref), activity|null (following|walking|running|idle|talking|sitting|waiting|carried), position|null, carried}. objects.catalogentries gain requiredcompanion: null, or{capable, name, reason|null}.npcs.aimed.interactions[].typegainscompanion(Stay and Follow).- Everything else is inherited from 0.24 unchanged;
session.helloreports0.25. Inheritance test included.
Object format 0.10 (draft): companion block
- Optional
companion {name? (1-32), followDistance? (1.5-2.5 m), idles? (<=4 unique clip names), say? (<=8 lines of <=160 characters)}, only on characters; idle variants must be clips oftraits.characterand not canonical RFC-0010 clip names (talkis a new canonical name).
@hyprune/schema 0.10.0 (2026-10-13)
Publishes IPC 0.25: companions. companion.set, companion.clear and companion.mode (follow or stay), a required companion state key, a companion capability on catalog entries and the aimed interaction type companion; and the object 0.10 draft companion block (name, followDistance, idles, say). Inherits 0.24.
@hyprune/schema 0.11.0 (2026-10-13): registry documents
Registry documents (RFC-0015), versioned independently under registry/v0.1/:
index.schema.json (index documents; $defs.entry for registry entry files),
release-record.schema.json and sources.schema.json. validateRegistry(kind, doc, version?) for kinds registry-index, registry-entry, release-record and sources
checks unique ids, versions unique and newest first (SemVer, no build metadata), tags
naming their version (v<version> or <name>-v<version>), SPDX licences, per-type
archive limits and custom source rules. New exports: registryVersions,
registryLimits, parseSemver, compareSemver, tagVersion. The CLI accepts the four
registry kinds. The package ships registry/. World formats and IPC are unchanged.
IPC 0.26: debug tool, companion pace, longer pocket list
- Tool 9, the debug tool:
interaction.tool,editor.tool,hud.pose.tool,tool.changed.slotandtoolDefinition.slotare 1-5 or 9;tool.changed.nameisdebugfor slot 9.editor.submodeadds the debug layer ids (windows,window-zones,collision,playable,paths,keep-clear,seats,visibility,steering;placementalready existed).editor.toolDefinitionslists six tools: slots 1-5, then slot 9. - Required
editor.debugTool: null while another tool is out, else{layer, label (<=64), index (0-based), count, legend [{label, colour [r,g,b] 0-1}] (<=8), card [string] (1-8 lines of <=256) | null}. - World action
tool9(required ininputConfig.modes.world). companionState.pace(walk|run) is required;companion.modetakes an optionalpace.editor.unplaced.windowsandmounts.instancesallow 128 items (the apps limit);editor.unplaced.countallows 144 (128 windows and the 16-item object pocket).- No new method, event or grant;
session.helloreports0.26. Inheritance test included.
@hyprune/schema 0.12.0 (2026-10-13)
Publishes IPC 0.26: tool 9 (the debug tool) with editor.debugTool and the world action tool9, the companion’s pace (companionState.pace, companion.mode pace) and 128-item pocket and mount-instance lists. Inherits 0.25.
Object format 0.11 (draft) and IPC 0.27 (draft): workspace screens
v0.11/object.schema.jsonandv0.11/library.schema.json: themounttrait is enabled.anchorsholds 1-4{id, role (mounted-workspace | tool-mount), mountType, pose, size, screenType?, frameNode?}; at most onemounted-workspaceanchor, which is 16:9 within 0.5 % or 21:9 (aspect 2.33-2.39) and at least 0.9 m high. Every anchor’s rectangle lies inside the bounds grown by 0.1 m;frameNodenames one scene node.mountcombines withdecorative,collidableandmovable. Below 0.11 the trait is rejected with “needs object format 0.11”. New exportsscreenAspectandscreenLimits; exampleexamples/object-screen.json.- IPC 0.27:
catalogEntry.screen(required: null or{aspect, size, mountType}) andobjectInstance.screen(required: null or{workspace, home, aspect, size}).objects.configurepatches andobjects.placetakeworkspace: 1-9999,"next-free"or null. New definitionsworkspaceId,screenAspect,catalogScreen,instanceScreen. No new method, event or grant;session.helloreports0.27. Inheritance test included.
Object format 0.11 sizes, import.json and IPC 0.27 catalog fields (drafts)
- Object format 0.11: for ordinary objects (not characters or items) the RFC-0011 budgets are
recommendations: over one is a warning (“(recommended; it still loads)”); only the new hard
caps refuse (
objectHardCaps: 2,000,000 triangles, 8,192 px textures, 1 GiB GPU, 100,000 proxy triangles, 256 files, 512 MiB per directory, 64 MiB per file). Formats 0.9 and 0.10, characters and items keep their budgets as errors. v0.11/import.schema.json:import.json(importVersion 0.1, RFC-0014) besideobject.json: source file (name, format, bytes, sha256), converter, options (units, scale, up, yaw, surface, triangle and texture targets, collision, KTX2, lighting), measures before and after, steps, the recorded licence/author/source and the import time.validate('import', record); the object check validates it withoptions.importRecord.- IPC 0.27 catalog entries gain required
warnings(at most 8),provenance(null or{license, author, source}, “unknown” where unrecorded) andimported(null or{at, sourceName}); new definitionscatalogProvenance,catalogImported.
World format 0.11, builder projects and IPC 0.27 builder state (drafts)
v0.11/world.schema.jsonandv0.11/common.schema.json: world format 0.11 (draft) inherits 0.9 and addsatmosphere.panorama{image, projection: "equirect", encoding?, intensity?, rotation?, maxResolution? (256-2048), environment?}. A 0.11 world may use object format 0.11 assets (workspace screens, imports);mountis no longer reserved in inline assets; movers stay reserved. World format 0.10 is not defined (worldFormatsskips it).v0.11/project.schema.json:builder/project.json(projectVersion 0.1): world id, name, starterflat-land@0.1, basebuilder/base.json, sky provenance and up to 128 placements{id: u-xxxxxx, ref: world/<id>, pose, scale, workspace?, locked?}.validate('project')adds unique ids, unit quaternions, one screen per workspace and the sky’s SPDX licence.- IPC 0.27: required state key
builder(null, or{projectId, worldId, name, folder, mode: "edit", revision, placements, sky, error}; also in deltas), catalog sourceworldandworld/<id>object refs. New definitionbuilderState.
@hyprune/schema 0.13.0 (2026-10-15)
Publishes IPC 0.27, world format 0.11 and object format 0.11, which were drafts until now and
are final as released here: workspace screens (the object mount trait, screen on catalog
entries and object instances, workspace on objects.configure and objects.place), object
format 0.11 size recommendations below objectHardCaps, import.json (importVersion 0.1),
catalog warnings, provenance and imported, world format 0.11 panorama skies and builder
worlds, builder/project.json (projectVersion 0.1) and the IPC 0.27 builder state key.
Object format 0.10 stays an unreleased draft (world format 0.10 is not defined); 0.11 carries
its additions. IPC 0.27 inherits 0.26.
Motion packs (motion.json 0.1) and IPC 0.28: the shared clip library
RFC-0010 amendment “Shared clip library”: clips on a named skeleton that every character with that skeleton can play.
motion/v0.1/motion.schema.json:motion.json(motionVersion 0.1), versioned on its own like the registry documents: packid,name,skeleton.id(mixamo-v1, the Mixamo humanoid), licence and attribution, 1-8rigs({id, scene}: clips-only.glbfiles beside it) and 1-128clips{name, role, style?, rig, clip?, loop?}. Roles: idle, walk, run, sit-down, stand-up, seated-idle, wave, talk, guide, dance.validateMotion(doc)adds unique rig ids and clip names, known rigs, a style on every dance, one clip per role and style, SPDX licences;motionClipName(role, style)gives the clip name a character plays (walk_confident,sitfor sit-down,sit_idlefor seated-idle). CLI kindmotion. No object or world format change: core takes a pack’s clips onto any character whose skeleton matches.- IPC 0.28 inherits 0.27 and adds: definitions
motionStyle,characterStyle({walk?, run?, idle?}),catalogMotion,interactionOption; requiredcatalogEntry.motion(null, or the styles per role, dances and packs of a character); requiredobjectInstance.style;styleonnpcs.spawnandnpcs.bind; the companion’s requiredstyleanddance, activitydancing, andcompanion.modestyle; the aimed interaction typedancewith required, nullableoptions(one per dance), andinteraction.chooseoption. No new method, event or grant;session.helloreports0.28. Inheritance test included.
0.14.0 — 2026-10-15
Publishes IPC 0.28 and motion packs (motion/v0.1/motion.schema.json, motionVersion 0.1),
which were drafts until now: character styles, companion dances and catalog motion (the
RFC-0010 shared clip library amendment). No object or world format change. IPC 0.28 inherits
0.27.
Mirrored from hyprune/schema at 34849da45183 (2026-10-15); 143 files with SHA-256 checksums in /schema/source.json.