Skip to content

t1k:playablelabs:ref:gamedev-adapter

FieldValue
Moduleref
Version2.9.1
Effortlow
Tools—

Keywords: playable pause resume capture, playablelabs page adapter, preview-verify adapter playablelabs, window.__qa ready

/t1k:playablelabs:ref:gamedev-adapter
(read by the gamedev resolver; no arguments)

PlayableLabs gamedev adapter: page runtime (extension slice)

Section titled “PlayableLabs gamedev adapter: page runtime (extension slice)”

The EXTENSION slice of the playablelabs engine adapter (the primary slice, with detect, is t1k-playablelabs-base-gamedev-adapter). It declares runtime.page and ships the one engine-bound file: scripts/page-adapter.cjs, createAdapter() returning {id, setFpsCap, waitReady, pause, resume}. A PlayableLabs web playable is not a Cocos scene: there is no cc.game, so the cap is a requestAnimationFrame gate, and “ready” is window.__qa.ready() from the layered template (src/platform/qa.ts in t1k-playablelabs-ref-pla-engine-from-ref). No hookTween: the template has no global tween registry.

The verification skill is t1k-gamedev-playable-preview-verify (theonekit-gamedev playable). Resolve the adapter, then pass the module path it prints:

Terminal window
bun .claude/scripts/gamedev-adapter.cjs resolve --capability runtime.page --engine playablelabs # prints module: <path>
bun .claude/skills/t1k-gamedev-playable-preview-verify/scripts/preview-verify.cjs <dist dir> --flow <flow.json> --adapter <module path>

Without theonekit-gamedev installed this skill does nothing; the playable then has no automated preview gate and the stage that needs it says so.

assets/flows/ holds the PlayableLabs-only flows the engine-neutral skill does not ship: liveness.flow.json (a tween advances over >= 2 frames, a fired effect leaves a non-empty pool) and cta-real-click.web.flow.json / cta-real-click.packed.flow.json (one trusted CDP mouse click produces exactly one CTA call, on dist and on the packed artifact). Run them with preview-verify --flow <file> --adapter <module path>.

Terminal window
bun test .claude/skills/t1k-playablelabs-ref-gamedev-adapter/tests/page-adapter.test.cjs
bun .claude/scripts/adapter-conformance.cjs <kit root> # theonekit-gamedev base script

No agent runs a mechanical step from this skill. scripts/page-adapter.cjs is a module the theonekit-gamedev preview-verify script loads in-process (--adapter <module path>); the skill itself is a lookup, so no cheap-tier executor is declared here.