airship-phaser/README.md

airship-phaser

Top-down Phaser.js airship combat prototype.

Development

npm install
npm test
npm run dev

Production builds run the regression suite before Vite:

npm run build

Runtime diagnostics

The browser keeps the latest 300 structured events in memory.

In Chrome DevTools:

airshipDebug.getLogs()
airshipDebug.snapshot()
airshipDebug.clearLogs()

Useful events include:

• scene:init, scene:create, scene:heartbeat, scene:shutdown
• combat:broadside-fired
• combat:player-hit-queued
• combat:player-hit-processed
• combat:pirate-hit
• game:finish
• hud:image-error, hud:helm-frame-error, hud:helm-knob-error
• runtime:error, runtime:unhandled-rejection

If gameplay appears frozen, inspect airshipDebug.snapshot() first, then the tail of airshipDebug.getLogs().