t1k:playablelabs:ref:gamedev-adapter
| Field | Value |
|---|---|
| Module | ref |
| Version | 2.9.1 |
| Effort | low |
| Tools | — |
Keywords: playable pause resume capture, playablelabs page adapter, preview-verify adapter playablelabs, window.__qa ready
How to invoke
Section titled “How to invoke”/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.
Verify a playable (the one command)
Section titled “Verify a playable (the one command)”The verification skill is t1k-gamedev-playable-preview-verify (theonekit-gamedev playable). Resolve the
adapter, then pass the module path it prints:
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.
Flows that need this page runtime
Section titled “Flows that need this page runtime”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>.
Check it
Section titled “Check it”bun test .claude/skills/t1k-playablelabs-ref-gamedev-adapter/tests/page-adapter.test.cjsbun .claude/scripts/adapter-conformance.cjs <kit root> # theonekit-gamedev base scriptExecuted by
Section titled “Executed by”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.