car-volleyball

Car volleyball against a trained bot, run entirely in the browser. The bot is trained by self-play in RocketSim, in a separate training repo (rocket-league-bot), and runs here through ONNX Runtime Web.

The plan and the build order are in docs/plan.md, and the terms it uses are in CONTEXT.md.

Running

git clone --recurse-submodules <this repo>
npm install
npm run build:wasm   # RocketSim to WASM; needs Emscripten 6.0.13 (em++ on PATH, or $EMXX)
npm test             # the parity fixtures
npm run dev

Git LFS holds the model files, so clone with LFS installed. RocketSim comes from the fork github.com/gebrial/RocketSim (branch static-collision-shapes, which adds the court's floor and net shapes) as the submodule vendor/RocketSim. wasm/bindings.cpp is what TypeScript sees of it, typed in src/physics.ts.

Releases

releases/<milestone>/ holds one web release each: release.json, the model split into policy.onnx.part* (each under 25 MiB), and the parity fixtures recorded in Python RocketSim. They come from the training repo:

python web_release.py <milestone> [--volleyball] --gravity <g> --boost-consumption <b>
python copy_web_release.py <milestone> ../car-volleyball

The tests run every release's fixtures, so a new release is covered as soon as it is copied in.

Rules fixtures

fixtures/volleyball-rules/rules_events.json comes from the training repo's python volleyball_fixtures.py, copied in by hand. src/volleyball.ts must replay every sequence in it with the same events and shot clock.

Physics fixtures

fixtures/physics/one_step.json comes from the training repo's python physics_fixtures.py, copied in by hand: whole car and ball states with controls, and the states 1 and 8 ticks later, in open air (at the soccer bot's 0.3804x gravity), on a flat floor, and on the volleyball court.