A local, offline Rocket League–style car-soccer game built for training: skilled bots to play against, focused drills for the mechanics that matter, a coach that tells you what to fix — plus the parts of RL that make it feel like RL: a garage, mutators, Rumble, five arenas and a local rank.
Runs entirely in the browser (React + Three.js + Vite). No servers, no accounts, no network needed after npm install.
npm install
npm run dev # http://localhost:5173
npm run build # static build in dist/ (open with `npm run preview`)
npm test # headless checks: UI, cars, mutators, rumble, renderer, replayWorks with keyboard + mouse or any gamepad (Xbox/PlayStation layouts). Two keyboard presets: Keyboard (WASD + Space jump / Shift boost) and RL default (LMB boost, RMB jump, Shift powerslide/air roll). Everything can be rebound in Settings.
Physics — Rocket League units and field layout (34 boost pads, 5-spawn kickoffs, RL gravity/ball/car constants). Jumps, double jumps, dodges, flip cancels (speed flips), air roll, free air roll (powerslide key + steer), powerslide, wall and ceiling driving with speed preserved through the curved ramps, wavedashes, demolitions, Psyonix hit impulse, supersonic. Fixed 120 Hz sim, boost locked during the countdown exactly like RL. Ball-cam lifts and pulls back as the ball climbs so high aerials stay framed.
Cars & garage — twelve cars across the six real hitbox classes (Octane, Dominus, Breakout, Plank, Hybrid, Merc) with Psyonix's actual hitbox dimensions, so a Batmobile really is 18 uu tall and a Merc really is 47. Only the hitbox differs — engine, boost, jump and flip are identical for every car, exactly like RL. The garage paints them: 20 colours × primary/accent, 8 finishes (glossy → chrome, metalflake, pearlescent, carbon), 6 wheel styles, 8 boost trails and 5 goal explosions, all previewed on a turntable behind the menu.
Mutators — the full private-match rule set: match length, max score, overtime (unlimited / 5 min / 10 min / off), ball size, weight, bounciness, speed and type (default or puck for Snow Day), boost (normal / unlimited / slow recharge / rapid recharge / none), boost strength (0.5×–10×), respawn time and demolition rules (default / disabled / always / instant / 3 s). One-click presets: Standard, Quick match, Rumble, Snow Day, Chaos.
Rumble — the power-up mode. Every car carries one of eight items — Boost, Grapple, Boot, Spike, Tornado, Haymaker, Power Shot, Swapper — boost is unlimited, and the item button (X, or D-pad up on a gamepad) fires it and starts a 10 s recharge (slow / turbo recharge available as mutators). Bots use their items too, with their own policy for each one.
Arenas — Night Stadium, DFH Day, Wasteland, Salty Shores and Mannfield. Each is a full re-theme: sky, sun, fog, exposure, pitch colour, wall panels, glass, LED strips, ceiling, stands, crowd and outer floor.
Bots — four difficulty levels: Rookie, Pro, All-Star, Grand Champion. Bots read a ball-prediction, choose roles (attack / shadow / save / boost) with teammates, take varied kickoffs (side-hits, diagonal flips, Champion speed-flips), defend rolling balls toward their own net, drive walls, jump-shot, dodge and aerial. All-Star and Grand Champion punish slow rotations and whiffs; Rookie and Pro make human-like reading and timing mistakes. Bots drive their own cars out of the catalogue.
Presentation — stadium arena with lit goals, boost pad glow, per-car models with wheels/boost trails/supersonic effects, five goal-explosion styles and slow-motion replays with a cinematic camera, ball-cam / free-cam with RL-style camera settings (FOV, distance, height, stiffness), engine/boost/impact audio, and a full HUD (boost gauge, speed, score, clock, kill feed, RL-style stat pop-ups — "+50 SAVE", "+75 EPIC SAVE", "+20 CLEAR BALL" —, hold-Tab scoreboard, MVP on the results screen, off-screen ball indicator, Rumble item meter, demolition/respawn timer, quick chat). Forfeit from the pause menu.
Modes
- Match — 1v1 / 2v2 / 3v3 vs bots, any arena, any mutator set, overtime, replays, boost management.
- Training drills — Shooting, Saves, Aerials, Dribbling, Kickoffs, Wall shots, Recovery. Each drill has levels that unlock as you succeed and gives feedback after every attempt. Drills always run on standard rules. The Aerials pack covers straight lobs, side aerials, drifting balls and ceiling drop shots, auto-enables the ball landing marker, and reports touch height / air time / boost left.
- Free play — you, the ball and your chosen arena.
Tresets. - Progress — local XP, level and season rank (Unranked → Supersonic Legend), per-drill best scores and streaks, match record, shot accuracy and the coach's notes.
Coach — watches your match and reports concrete things to work on (boost starvation, slow rotations, whiffed challenges, kickoffs lost, etc.).
| Action | Key |
|---|---|
| Throttle / Reverse | W / S |
| Steer | A / D |
| Jump | Space |
| Boost | Shift |
| Powerslide / Air roll | Ctrl or F |
| Air roll left / right | Q / E |
| Free air roll (hold) + steer | Ctrl/Shift + A/D — A rolls left, D rolls right |
| Use Rumble item | X (gamepad: D-pad up) |
| Ball cam | C |
| Scoreboard (hold) | Tab |
| Quick chat | 1 – 4 |
| Rear view | R |
| Ball prediction | P |
| Hitbox overlay | H |
| Pause | Esc |
Headless simulations and checks (Node, no browser needed):
npm test # UI + cars + mutators + rumble + renderer + replay
node scripts/sim.mjs champion 2 120 # bot-vs-bot match: difficulty, team size, seconds
node scripts/cartest.mjs # hitbox table, per-car physics, 576 cosmetic combos, mutator math
node scripts/mutatortest.mjs # every rule modifier applied to a real match
node scripts/rumbletest.mjs # each power-up fired and its effect measured
node scripts/drills.mjs # run every drill with a Champion bot as the "player"
node scripts/drilltrace.mjs wallshots
node scripts/hit.mjs # hit/dodge/jump physics numbers
node scripts/uitest.mjs # jsdom smoke test of menus/HUD/input/garage/XP
node scripts/rendertest.mjs # renderer: arenas, turntable, loadouts, goal explosions
node scripts/replaytest.mjs # goal → replay → countdown state machine
node scripts/walltest.mjs # wall driving speed / height numbers
node scripts/kosym.mjs allstar # kickoff 50/50 outcomes (both bots)
node scripts/kodrill.mjs champion # kickoff drill with a bot as the player