Made of little things.

# Supersonic RC Revive

A faithful remake of the 2004 Shockwave RC-car game SuperSonic RC, rebuilt with
three.js and Rapier as a [NIP-5D](docs/nip-5d.md) napplet. The car handling is
ported line by line from the original Lingo scripts. The game includes all five
modes: Free Driving, Checkpoint Chase, Stunt Rally, Scavenger Hunt and the
Supersonic Challenge.

The original game is preserved on the Internet Archive:
[LEGO Super Sonic RC](https://archive.org/details/lego-super-sonic-rc).

## Playing

Drive with the arrow keys or WASD, a gamepad, or the on-screen touch controls.
Space brakes hard, Esc quits to the menu and M toggles sound. Unlocked modes are
saved through the host's storage, when the host provides it.

The published game ships a recreated asset pack, "Bedroom Grand Prix". To play
with a different pack, choose **Asset pack…** on the title screen and either
paste the pack's Blossom link or hash, or choose a `.ssrcpack` file. To share a
pack, upload it to any Blossom server and send the link.

## Development

```bash
soyli setup
soyli dev          # hosted preview; stop it when you are done
pnpm verify        # guidance test + type-check + build
pnpm test:conformance
```

Read [docs/napplet-space.md](docs/napplet-space.md) for the soyli commands and
host capabilities.

| Path | Contents |
| --- | --- |
| `src/game/lingo/` | The ported game logic: car, wheels, modes, scoring |
| `src/game/physics/` | The Havok stand-in on Rapier |
| `src/game/render/`, `src/game/ui/` | three.js scene, HUD and screens |
| `src/game/assets-custom/` | Source of the recreated asset pack |
| `tools/assets/` | Building and registering asset packs ([README](tools/assets/README.md)) |
| `tools/` | Extraction tools for the original game, for local reference only ([README](tools/README.md)) |
| `docs/original-game-spec.md` | What the original game does, recovered from its scripts |
| `docs/physics-calibration.md` | How the physics port was checked against the original |

The original game's assets are copyrighted. The extraction tools keep them in
gitignored folders (`ref/`, `ref-out/`); never commit, publish or upload them.

## License

MIT. See [LICENSE](LICENSE).