Skip to content

Input keymap 0.9

Schema reference / Input keymap / 0.9

Keymap v2: per-mode actions with up to three bindings each, hold timing and capture limits. Directory versions follow the IPC revision that introduced them.

Status
Latest
Published
2026-10-08
Dialect
JSON Schema 2020-12 · unknown fields rejected unless marked
Raw schemainput.schema.json · 518 lines · 13 KB
DownloadOpen rawsha256 a069cb5db721…
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://hyprune.com/schema/v0.9/input.schema.json",
"type": "object",
"properties": {
"version": {
"const": 2
},
"longHoldMs": {
"type": "integer",
"minimum": 100,
"maximum": 5000
},
"scopeVignette": {
"type": "boolean"
},
"useDistance": {
"type": "number",
"minimum": 0.2,
"maximum": 30
},
"useTolerance": {
"type": "number",
"minimum": 0,
"maximum": 0.5
},
"captureInputLimit": {
"type": "integer",
"minimum": 16,
"maximum": 1024
},
"modes": {
"type": "object",
"properties": {
"world": {
"type": "object",
"properties": {
"look": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"forward": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"back": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"left": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"right": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"menu": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"sprint": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"up": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"down": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"use": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"focus": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"noclip": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"scope": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"debug": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"capture": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"carry": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"resize": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"distance": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"rotate": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"tool1": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"tool2": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"tool3": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"tool4": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"hud.cycle": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"transport": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"autopilot": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"primary": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"secondary": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"wheel": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"fly": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
}
},
"required": [
"look",
"forward",
"back",
"left",
"right",
"menu",
"sprint",
"up",
"down",
"use",
"focus",
"noclip",
"scope",
"debug",
"capture",
"carry",
"resize",
"distance",
"rotate",
"tool1",
"tool2",
"tool3",
"tool4",
"hud.cycle",
"transport",
"autopilot",
"primary",
"secondary",
"wheel",
"fly"
],
"additionalProperties": false
},
"interactive": {
"type": "object",
"properties": {
"exit": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"debug": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"capture": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
}
},
"required": [
"exit"
],
"additionalProperties": false
},
"focus": {
"type": "object",
"properties": {
"exit": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"debug": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"capture": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
}
},
"required": [
"exit"
],
"additionalProperties": false
},
"menu": {
"type": "object",
"properties": {
"exit": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"debug": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
},
"capture": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 96
},
"maxItems": 3,
"uniqueItems": true
}
},
"required": [
"exit"
],
"additionalProperties": false
}
},
"required": [
"world",
"interactive",
"focus",
"menu"
],
"additionalProperties": false
},
"invert_y": {
"type": "boolean",
"description": "Invert vertical mouse look; default false."
},
"show_area_markers": {
"type": "boolean",
"description": "Render optional place/area labels in core; default false."
}
},
"required": [
"version",
"longHoldMs",
"scopeVignette",
"useDistance",
"useTolerance",
"captureInputLimit",
"modes"
],
"additionalProperties": false
}

Changes since 0.6

Structural diff against 0.6: 1 definition changed. Descriptions and $id changes are ignored.

1 change
  • changedtop-level fields
    • + modes.world.hud.cycle string[] (required) · items ≤ 3 · unique items · each length 1–96
    • − modes.world.tool5

Fields

FieldTypeConstraints
versionrequired2
longHoldMsrequiredinteger≥ 100 · ≤ 5000
scopeVignetterequiredboolean
useDistancerequirednumber≥ 0.2 · ≤ 30
useTolerancerequirednumber≥ 0 · ≤ 0.5
captureInputLimitrequiredinteger≥ 16 · ≤ 1024
modesrequiredobject
worldrequiredobject
lookrequiredstring[]items ≤ 3 · unique items · each length 1–96
forwardrequiredstring[]items ≤ 3 · unique items · each length 1–96
backrequiredstring[]items ≤ 3 · unique items · each length 1–96
leftrequiredstring[]items ≤ 3 · unique items · each length 1–96
rightrequiredstring[]items ≤ 3 · unique items · each length 1–96
menurequiredstring[]items ≤ 3 · unique items · each length 1–96
sprintrequiredstring[]items ≤ 3 · unique items · each length 1–96
uprequiredstring[]items ≤ 3 · unique items · each length 1–96
downrequiredstring[]items ≤ 3 · unique items · each length 1–96
userequiredstring[]items ≤ 3 · unique items · each length 1–96
focusrequiredstring[]items ≤ 3 · unique items · each length 1–96
nocliprequiredstring[]items ≤ 3 · unique items · each length 1–96
scoperequiredstring[]items ≤ 3 · unique items · each length 1–96
debugrequiredstring[]items ≤ 3 · unique items · each length 1–96
capturerequiredstring[]items ≤ 3 · unique items · each length 1–96
carryrequiredstring[]items ≤ 3 · unique items · each length 1–96
resizerequiredstring[]items ≤ 3 · unique items · each length 1–96
distancerequiredstring[]items ≤ 3 · unique items · each length 1–96
rotaterequiredstring[]items ≤ 3 · unique items · each length 1–96
tool1requiredstring[]items ≤ 3 · unique items · each length 1–96
tool2requiredstring[]items ≤ 3 · unique items · each length 1–96
tool3requiredstring[]items ≤ 3 · unique items · each length 1–96
tool4requiredstring[]items ≤ 3 · unique items · each length 1–96
hud.cyclerequiredstring[]items ≤ 3 · unique items · each length 1–96
transportrequiredstring[]items ≤ 3 · unique items · each length 1–96
autopilotrequiredstring[]items ≤ 3 · unique items · each length 1–96
primaryrequiredstring[]items ≤ 3 · unique items · each length 1–96
secondaryrequiredstring[]items ≤ 3 · unique items · each length 1–96
wheelrequiredstring[]items ≤ 3 · unique items · each length 1–96
flyrequiredstring[]items ≤ 3 · unique items · each length 1–96
interactiverequiredobject
exitrequiredstring[]items ≤ 3 · unique items · each length 1–96
debugstring[]items ≤ 3 · unique items · each length 1–96
capturestring[]items ≤ 3 · unique items · each length 1–96
focusrequiredobject
exitrequiredstring[]items ≤ 3 · unique items · each length 1–96
debugstring[]items ≤ 3 · unique items · each length 1–96
capturestring[]items ≤ 3 · unique items · each length 1–96
menurequiredobject
exitrequiredstring[]items ≤ 3 · unique items · each length 1–96
debugstring[]items ≤ 3 · unique items · each length 1–96
capturestring[]items ≤ 3 · unique items · each length 1–96
invert_yboolean

Invert vertical mouse look; default false.

show_area_markersboolean

Render optional place/area labels in core; default false.

Examples

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

placement-input.jsonplacement-input.json · 169 lines · 2.4 KB
{
"version": 2,
"longHoldMs": 1000,
"scopeVignette": true,
"invert_y": false,
"useDistance": 6,
"useTolerance": 0.12,
"captureInputLimit": 256,
"modes": {
"world": {
"look": [
"MouseMove"
],
"forward": [
"k",
"w",
"Up"
],
"back": [
"j",
"s",
"Down"
],
"left": [
"h",
"a",
"Left"
],
"right": [
"l",
"d",
"Right"
],
"menu": [
"Tab[L]"
],
"sprint": [
"Shift_L"
],
"up": [
"space"
],
"down": [
"Control_L"
],
"use": [
"e"
],
"focus": [
"f"
],
"noclip": [
"v"
],
"scope": [
"q"
],
"debug": [
"F3",
"y"
],
"capture": [
"u"
],
"carry": [
"Super+LMB"
],
"resize": [
"Super+RMB"
],
"distance": [
"Super+Wheel"
],
"rotate": [
"Super+Ctrl+Wheel"
],
"tool1": [
"1"
],
"tool2": [
"2"
],
"tool3": [
"3"
],
"tool4": [
"4"
],
"hud.cycle": [],
"transport": [
"z"
],
"autopilot": [
"x"
],
"primary": [
"LMB"
],
"secondary": [
"RMB"
],
"fly": [
"F4"
],
"record.toggle": [],
"exit": [
"Super+Tab",
"Back"
],
"tool5": [
"5"
],
"content.scale": [
"Super+Shift+Wheel"
],
"window.reset": [
"Super+Shift+MMB"
],
"carry.facing": [
"r"
],
"alternate": [
"MMB"
],
"cycle": [
"Wheel"
]
},
"interactive": {
"exit": [
"Super+Tab",
"Back"
],
"debug": [
"F3"
],
"capture": [
"Super+u"
],
"record.toggle": []
},
"focus": {
"exit": [
"Super+Tab",
"Back"
],
"debug": [
"F3"
],
"capture": [
"Super+u"
],
"record.toggle": []
},
"menu": {
"exit": [
"Escape"
],
"debug": [
"F3"
],
"capture": [
"Super+u"
],
"record.toggle": []
}
},
"show_area_markers": false
}

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