A byte-faithful remake of the 2007 Flash classic Boxhead: 2Play Rooms (by Sean Cooper), reverse-engineered from the original SWF and rebuilt in TypeScript + Canvas2D + Electron. Every value, state machine, timing, layout — even the original's quirks — is preserved and pinned by tests, while the remake adds 2×-resolution rasterization, save & resume, gamepad support and LAN multiplayer.
- Class-by-class port — all 114 ActionScript 2 classes ported file-by-file (
src/game/);[BC]comments trace every suspicious line back to a SWF bytecode offset. - A hand-written deobfuscator — the original SWF ships control-flow-flattened, so ffdec output is unreliable; this project has its own AVM1 disassembler and resolves disputed code against the real bytecode.
- Original look & sound — art, fonts and audio are extracted from the original SWF by the project's own
extractor (no Java, no ffdec) and committed to the repo, so a standard build never touches the SWF. A real
Flash Player in
assets/runs injected probes (for..in order, filter pixels, …) as test goldens.
Windows portable (recommended)
npm install
npm run dist # -> release/Boxhead 2Play Rooms-<version>-portable.exeDouble-click the single-file exe (saves live next to it in Boxhead2PlayRooms-data/). The first packaging
downloads toolchain bits — prefix NODE_USE_ENV_PROXY=1 if your network needs it — and SmartScreen's
"unknown publisher" prompt just chooses Run anyway.
Browser
npm install
npm run dev # http://localhost:5173/| Action | Player 1 | Player 2 |
|---|---|---|
| Move | Arrow keys | W A S D |
| Shoot | / (Space in Single) |
Space |
| Switch weapon | . / , |
E / Q |
| Direct select (Single) | 1–0 | — |
P pauses, F11 fullscreen, right-click for sound / quality / render scale. Gamepads work everywhere
(stick to move, RT/A to shoot, START to pause); keys are rebindable on the level-select screen.
- Save & resume — pause-menu SAVE & QUIT, main-menu CONTINUE; death RETRY restarts at the failed wave (wave-start checkpoint, or the run's starting wave when none exists yet — score/weapons reset as in the original retry).
- Coop death weapon crate — a fallen player drops their whole arsenal with live ammo; pickup restores the owner exactly and gives the teammate the best of both.
- Start-wave selector with progression — the level-select
START WAVEcycler lets you jump straight back to the best wave you have fought up to (shown asBESTbeside it), with the loadout the original's difficulty curve would have granted by then. A fresh save can only start at wave 1 — the historical best persists in the save and caps the cycler; in LAN the host's best is the cap. - LAN multiplayer (portable build) — host & auto-discover or join by IP, lockstep-verified co-op and death match with 30 s reconnect + checkpoint resume (~2–4 KB/s each way). After a finished match either player can RETRY straight from the debrief (checkpoint first, else a fresh run at the failed wave), and local-player display prediction keeps control feeling like single-player even on 60 ms-class links.
- One data folder — every build (the portable exe included) keeps all user game data — saves and settings —
in
%USERPROFILE%\.boxhead, migrated there automatically on first run: one folder to manage and back up.
All 27 deviations are registered in src/game/deviations.ts and audited in
PARITY.md: sponsor content (CMG logo, online scores, external links) is replaced by local
highscores; timing stays at the original 50 fps logic on any refresh rate.
npm test # unit + headless-simulation suites (incl. Flash-player golden diffs)
npm run typecheck
npm run build # renderer build (asset extraction is skipped when up to date)
npm run extract # regenerate public/assets from assets/boxhead_2play_rooms.swfLayout: src/engine/ — Flash API subset + display-list player + platform layer; src/game/ — the ported
classes; tools/ — the SWF extractor and AVM1 toolchain; tests/ — unit, sim and real-playtest suites;
assets/ — the original SWF and the reference Flash players. Engineering rules: CONVENTIONS.md.
gallery.html (via npm run dev) browses every symbol of the original SWF.
The original Boxhead: 2Play Rooms is © Sean Cooper (2007), sponsored by Crazy Monkey Games. The assets in this repository are extracted from the original SWF for learning and research only — do not use them commercially. Fan project, not affiliated.
- Original author: seantcooper.com
- Issues & PRs: github.com/Xi-Gong/boxhead_res