Manifest Reference

bodylink.game.json is your game's contract with the BodyLink host: its identity, its entry point, the security policy for its iframe, the capabilities it needs, and how it appears in the catalog. It ships inside the bundle and is immutable per <slug>@<version> — a new release is a new version.

This page annotates every field. It does not restate the normative Runtime v1 contract — for coordinate/calibration semantics it links the feature guides.

The full manifest, annotated

{
          // ---- Identity ----
          "id": "tv.bodylink.games.myslug",   // permanent, globally-unique id
          "name": "My Slug",                   // human display name
          "version": "1.0.0",                  // semver; bump for every release
          "runtimeRange": "^1.0.0",            // host runtimes this bundle accepts
          "runtime": "bodylink-runtime-v1",    // the runtime family

          // ---- Entry point ----
          "entry": {
            "kind": "iframe",                  // Runtime v1 = iframe entry (NOT "module")
            "html": "index.html"               // bundle-relative entry HTML
          },

          // ---- Iframe session security ----
          "iframeSession": {
            "channel": "postmessage",
            "allowedParentOrigins": [          // explicit hosts allowed to embed you
              "http://127.0.0.1:7500",         // your dev server
              "http://127.0.0.1:7320",         // the self-hosted runner (dev:hosted)
              "https://bodylink.tv"            // production
            ],
            "sandbox": ["allow-scripts"]       // allow-scripts only; never allow-same-origin
          },

          // ---- Catalog art ----
          "assets": {
            "catalog": {
              "thumbnail": { "path": "assets/catalog/thumbnail.svg", "type": "image/svg+xml" },
              "preview":   { "path": "assets/catalog/preview.svg",   "type": "image/svg+xml" }
            }
          },

          // ---- Capabilities ----
          "capabilities": [
            "iframe.bundle.v1",                // required for iframe entries
            "sdk.proxy.v1",                    // required for iframe entries
            "tracking.frame",                  // receive pose frames
            "input.remote",                    // receive remote/controller input
            "diagnostics.runtime"
          ],

          // ---- Calibration defaults ----
          "calibration": {
            "mode": "upperBodyAction",
            "profile": "upperBody",
            "params": { "source": "external-myslug" }
          },

          // ---- Permissions ----
          "permissions": { "network": false },

          // ---- Optional tracking/coordinate declarations (additive) ----
          "coordinate": {
            "mode": "full",                    // "full" (default) | "roi"
            "framing": "full-body",            // "full-body" (default) | "upper-body"
            "calibration": "none",             // optional: skip the get-ready ceremony
            "debugOverlay": "off"              // overlay's initial mode at entry
          },

          // ---- Launcher: how you appear + tracking budget ----
          "launcher": {
            "id": "myslug",
            "name": "My Slug",
            "description": "Touch the rings with one hand to score.",
            "color": "#38BDF8",
            "gridSize": "2x2",
            "tags": ["arcade", "hand-tracking"],
            "howToPlay": [
              "Reach one hand to touch the glowing rings.",
              "Clear all rings to start the next round."
            ],
            "showScore": false,
            "requiresCamera": true,
            "showWebcam": true,
            "showSkeleton": false,
            "launchLifecycle": {
              "cameraStart": "deferred-to-game",
              "countdown": "deferred-to-game",
              "getReady": "deferred-to-game"
            },
            "trackingFocus": "hand",
            "trackingPreset": "handAction",
            "trackingTier": "standard",
            "trackingPolicy": {
              "profile": "latency",
              "targetFps": 60,
              "cameraMaxWidth": 960,
              "cameraMaxHeight": 540,
              "minHandConfidence": 0.32,
              "holdMs": 220,
              "stableJitterPx": 0.05
            },
            "calibration": "hands"
          }
        }
        

Identity

Entry

Iframe session

Capabilities

Declare exactly what your game uses. Iframe entries must include both iframe.bundle.v1 and sdk.proxy.v1. Add tracking.frame, input.remote, diagnostics.runtime, and — if used — camera.preview / camera.photo. A capability your game uses but didn't declare is refused at runtime; the Validation Reference lists the codes.

Calibration (top-level)

Your game's default calibration request: mode, profile (e.g. upperBody), and free-form params. To skip the get-ready ceremony entirely, use the coordinate.calibration: "none" opt-in — see No-Calibration Opt-In.

Permissions

The coordinate block (optional, additive)

All optional; an undeclared bundle keeps the defaults.

The launcher block

Display + tracking metadata for the catalog. A missing block is bundle.launcher_missing; a missing required field is bundle.launcher_field_missing.

launcher.trackingTier

The tier sets the pose-inference budget (pose max dimension, pose model) and nothing else.

The tier owns the budget. Do not also put poseMaxDim / poseModel in trackingPolicy unless the tier is "custom" — validate rejects that conflict fail-closed. The template's standard tier already supplies 640, so its trackingPolicy carries no poseMaxDim.

launcher.trackingPolicy

Per-game tracking knobs. Common fields (from the scaffold):

Tune these to your game's feel. Keep them explicit; only add poseMaxDim / poseModel here when trackingTier is "custom".

Related pages

• Your First Game with Vite — a minimal manifest in context.
• Validation Reference — every named check and its fix, including the manifest checks above.
• Allowed Parent Origins — the allowedParentOrigins list in depth.