Terminal
Terminal/Skill
Reads live state from a running PlayCanvas app through the Engine devtools hook, without adding debug code to the app.
By PlayCanvas
Works with
npx skills add playcanvas/skills --skill inspect-runtimeFrom Engine 2.23, every app announces itself to a hook at
globalThis[Symbol.for('playcanvas.inspector')]. Read live state through it instead of adding
window.app or debug code to the app.
scripts/devtools-hook.js relative to this skill and inject it as an init script that
runs before any page script. A hook defined later misses existing apps; reload instead.globalThis.__playcanvasApps, a Map from each live app to
{ version, revision, protocol }. app.init() adds the entry and app.destroy() removes it.devtools: false. The Engine swallows errors thrown by the hook.playcanvas/debug, build/playcanvas.dbg.*) announces apps; the
default import never calls the hook. Later 2.23 patches fix every build.frameend, so values reflect a rendered frame.app.root.findByName() and findByTag(), world positions and
meshInstance.aabb, app.stats.drawCallCount and frameTime, and
entity.anim.baseLayer.activeState.app.timeScale = 0; update still runs with a zero dt. Step one frame by restoring
the scale, then zeroing it again on the next frameend.@playcanvas/inspector adds a panel for people: new Inspector(app) shows the hierarchy, assets,
materials, shaders, textures, render targets, frame graph, and physics. It must import the app's
own playcanvas package, so add it only to development builds. It draws over the canvas and
applies view overrides, so destroy it before verify-pixels captures. Stepping through draws
needs the debug build.