gpt-bomber/README.md
2026-03-08 11:39:57 +01:00

1.3 KiB

GPT Bomber

A fully original Bomberman-style browser game built from scratch.

Features

  • Grid-based bomb combat with chain reactions
  • Destructible crates and hidden powerups (bomb, flame, speed)
  • 3 CPU opponents with survival + attack behavior
  • Original visual assets (logo, characters, tiles, icons) in local SVG files
  • Original procedural audio (looping music + SFX) synthesized with Web Audio
  • Keyboard and controller support
  • Startup menu with mode selection (Single Player / Multiplayer) and music toggle
  • Multiplayer name setting from menu (Name: ...) with local persistence
  • Multiplayer lobby with host-controlled start (can start with 1-4 players)
  • After each multiplayer round, host can start the next round directly (no lobby required)
  • Host-authoritative multiplayer sync via WebSocket backend

Run

Install dependencies and run the backend server:

npm install
npm start

Then open:

http://localhost:8080

Controls

  • Move: WASD or Arrow Keys
  • Bomb: Space or Enter
  • Menu: Esc / P
  • Menu Select: Enter / Space
  • Controller: D-pad move, A bomb/select, Start open menu

Multiplayer Notes

  • For LAN/internet play, run the server on a reachable machine and open http://<server-ip>:8080 from each client.
  • The first active lobby player becomes host and can start with fewer than 4 players.