Bhaag Cockroach Bhaag
"Resign kar yaar." A mobile-first 3D endless runner (satire) set on a Jantar Mantar street. You are a cockroach running from a lathi-wielding constable: ride ramps onto bus roofs, grab chai and witness tokens, bank power-ups, and try not to get detained. Fan satire, not affiliated with any movement, party or person.
Run it
npm start # http://127.0.0.1:8000 (allowlist-only, loopback-only server)
npm test # unit tests for all game logic and the server allowlist
Open it on a phone through a tunnel (for example ngrok http 127.0.0.1:8000).
Controls
Swipe left/right to change lane, up to jump, down to slide, tap to use a banked power-up. Keyboard: arrows or WASD, Space, M to mute.
Characters
Pick on the start screen with the swipe carousel (swipe, arrow keys, or tap a card): Cockroach, Spider-Hero, Straw Hat Kid. The choice is remembered.
Customising
- Posters: on the start screen, "Add your posters" lets each player pick images from their own device. They are downscaled and kept in the browser (IndexedDB), never uploaded, and replace the built-in generic slogan posters everywhere. "Reset posters" removes them.
assets/posters/manifest.json can still list bundled posters by role (banner, road, standee, building); it ships empty.
assets/sfx/manifest.json - custom sound clips per game event (see assets/sfx/README.md).src/stages.js - stages, hazards, slogans (the slogans are tone placeholders).- Dev flags:
?autostart, ?stampede, ?skip=N, ?over, ?tut=chai, ?resettut.
Analytics (PostHog, optional)
Anonymous play events (run started/ended, chai, witness, power-ups, WiFi revive) are sent to PostHog when POSTHOG_PROJECT_TOKEN and POSTHOG_HOST are set. Copy .env.example to .env and fill them in; npm start loads it (needs Node 22.9+). Without them nothing is sent. Autocapture, session replay and Do-Not-Track-ignoring are disabled. Only the public project token is used; never put a personal API key (phx_...) in this repo.
Safety notes
serve.mjs serves only the game files, so .git, docs and tests are never exposed. Do not replace it with a general static server when sharing publicly.
Credits
See assets/CREDITS.md. Three.js is MIT (vendor/THREE-LICENSE). Kenney models are CC0. The humanoid cockroach is by Gandpop. Posters and sounds are generated in code; no real-person likeness or voice is used.
