gpt-bomber/README.md

43 lines
1.4 KiB
Markdown

# 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)
- Lobby shows when a match is currently running; waiting players auto-join the next round
- 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:
```bash
npm install
npm start
```
Then open:
```text
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.