147 lines
6.1 KiB
Markdown
147 lines
6.1 KiB
Markdown
# Ravaged Planet
|
||
|
||
A modern [Scorched Earth](https://en.wikipedia.org/wiki/Scorched_Earth_(video_game)) clone.
|
||
|
||
[Play it now](https://ravaged-planet.atroshin.ru)
|
||
|
||
|
||
|
||
## How to play
|
||
|
||
Tanks take turns to shoot at other tanks. The last surviving tank wins the round. Player 1 (red) is controlled via the keyboard, while other players are randomly-picked AIs. You can also play online against friends (see [Multiplayer](#multiplayer)).
|
||
|
||
Use the start menu to configure players (3-10), rounds (1-10), and terrain type before each battle. Between rounds, visit the market to spend your score on weapons.
|
||
|
||
## Multiplayer
|
||
|
||
Play over the internet (or LAN) with up to 6 human players; the remaining slots are filled by AIs. The game uses a **host-authoritative** model: one player's browser runs the simulation, a tiny Node.js relay forwards messages between players, and the other players render from synchronized snapshots.
|
||
|
||
### Running the relay
|
||
|
||
```sh
|
||
cd server
|
||
npm install
|
||
PORT=8090 npm start
|
||
```
|
||
|
||
### Playing
|
||
|
||
1. Open the game and set **Mode → Multiplayer** in the start menu.
|
||
2. Pick **HOST GAME** to create a room — you'll get a 6-character room code. The host configures total players, rounds, and terrain in the lobby, then presses START GAME.
|
||
3. Other players pick **JOIN GAME** and enter the code (plus their name).
|
||
4. Play as usual: aim, fire, and shop in the market. The host's browser simulates the game for everyone; other players can take their turns from anywhere.
|
||
|
||
### Hosting options
|
||
|
||
- **Same machine as the game** (default): the relay URL is derived from the page URL, so a reverse proxy can forward `/ws` to the relay port.
|
||
- **Dev/LAN override**: point the game at any relay with `?relay=ws://HOST:PORT` (e.g. `http://localhost:8123/?relay=ws://localhost:8090`).
|
||
|
||
Example nginx location for the WebSocket endpoint:
|
||
|
||
```nginx
|
||
location /ws {
|
||
proxy_pass http://127.0.0.1:8090;
|
||
proxy_http_version 1.1;
|
||
proxy_set_header Upgrade $http_upgrade;
|
||
proxy_set_header Connection "upgrade";
|
||
}
|
||
```
|
||
|
||
### How it works (short)
|
||
|
||
- The relay (`server/server.js`) only routes messages: joins, rosters, commands (client → host), and broadcasts (host → clients). It holds no game state.
|
||
- The host broadcasts a world snapshot on every state change (and every 100–250 ms during projectile/explosion resolution), plus the terrain bitmap as a PNG whenever it changes (craters, collapse, napalm).
|
||
- Clients render by applying snapshots to the same game code; they simulate nothing, and their aim/fire/market actions are sent as commands to the host.
|
||
|
||
### Control flow
|
||
|
||
- Turn-based rounds, market economy, and scoring work exactly as in single-player.
|
||
- If a remote player doesn't fire within 45 seconds of their turn starting, the host auto-fires for them.
|
||
- If the host leaves, the game ends for everyone.
|
||
|
||
### Controls
|
||
|
||
| Key | Function | With Shift | With Alt |
|
||
|-|-|-|-|
|
||
| Up/Down | Increase/decrease firing power | Increase/decrease by 10 | Increase/decrease slowly |
|
||
| Left/Right | Aim higher/lower | Increase/decrease by 10 | Increase/decrease slowly |
|
||
| Tab | Switch to your next weapon | Switch to your previous weapon | |
|
||
| Space | Fire | | |
|
||
|
||
### Market controls
|
||
|
||
| Key | Function |
|
||
|-|-|
|
||
| Up/Down | Navigate items |
|
||
| Right | Buy item |
|
||
| Enter | Start round |
|
||
|
||
## Features
|
||
|
||
- [X] Up to ten players with menu configuration
|
||
- [X] Multi-round battles with score tracking
|
||
- [X] Weapons & tools market (buy/sell)
|
||
- [X] Napalm weapons with liquid physics, fire propagation, and smoke effects
|
||
- [X] Animated terrain collapse (pixel-level gravity simulation)
|
||
- [X] Colorful retro graphics with 8×16 / 8×8 bitmap fonts
|
||
- [X] Frame-rate independent physics
|
||
- [X] Special graphic effects
|
||
- [X] Bullet physics, traces and sounds
|
||
- [X] Randomly generated terrains (Mountain, Sand)
|
||
- [X] Wide assortment of weapons
|
||
- [ ] Wide assortment of tools (only shields and parachutes implemented)
|
||
- [ ] Many different tanks to pick from
|
||
- [ ] Many AIs to battle against (only Moron and Chooser implemented)
|
||
- [ ] Configuration
|
||
- [X] Internet Multiplayer (host-authoritative, via `server/` relay)
|
||
|
||
## What's new
|
||
|
||
This fork adds significant enhancements over the original game:
|
||
|
||
- UI panels for start menu, market, round-end, and game-over screens
|
||
- Full mouse and touchscreen support for all menus and in-game controls
|
||
- Multi-round battles with persistent score tracking and weapon purchasing
|
||
- Improved visual effects: lava explosions, enhanced flame animation, and particle effects
|
||
- Napalm and Hot napalm weapons
|
||
- Online multiplayer (up to 6 humans + AI fill) with a Node.js relay server
|
||
|
||
## Weapons
|
||
|
||
| Weapon | Projectile | Effect | Price |
|
||
|-|-|-|-|
|
||
| Tracer | Normal | Light tracer round, no blast | FREE |
|
||
| Baby Missile | Normal | Small blast (r=5) | FREE |
|
||
| Missile | Normal | Medium blast (r=20) | $15 |
|
||
| Baby Nuke | Normal | Large blast (r=50) | $25 |
|
||
| Nuke | Normal | Huge blast (r=100) | $50 |
|
||
| Napalm | Normal | Emits 32 napalm particles, fire burns 3s | $20 |
|
||
| Hot Napalm | Normal | Emits 64 napalm particles, fire burns 3s | $40 |
|
||
| Baby Roller | Roller | Bouncing roller, small blast (r=15) | $15 |
|
||
| Roller | Roller | Bouncing roller, medium blast (r=35) | $25 |
|
||
| Super Roller | Roller | Bouncing roller, large blast (r=60) | $40 |
|
||
| MIRV | MIRV (3-way) | Triple split shot | $25 |
|
||
| X-MIRV | MIRV (5-way) | Five-way split shot | $50 |
|
||
| Leapfrog | Leapfrog (3 bounces) | Bounces 3 times, progressive power | $25 |
|
||
| Super Leapfrog | Leapfrog (6 bounces) | Bounces 6 times, progressive power | $40 |
|
||
| Small Dirt | Normal | Dirt spray (r=25), no damage | $10 |
|
||
| Dirt | Normal | Dirt spray (r=50), no damage | $20 |
|
||
| Ton of Dirt | Normal | Dirt spray (r=75), no damage | $35 |
|
||
| Small Dig Bomb | Normal | Digs crater (r=25), no damage | $10 |
|
||
| Dig Bomb | Normal | Digs crater (r=50), no damage | $20 |
|
||
| Large Dig Bomb | Normal | Digs crater (r=75), no damage | $35 |
|
||
|
||
### Tools
|
||
|
||
| Tool | Effect | Price |
|
||
|-|-|-|
|
||
| Parachute | Reduces fall damage | $30 |
|
||
| Shield | Absorbs damage (single use) | $50 |
|
||
|
||
## License
|
||
|
||
Licensed under the MIT LICENSE.
|
||
|
||
Original game (c) 2019 zenoamaro <zenoamaro@gmail.com>
|
||
This fork is meant to enhance original game.
|