HoverbikeDeveloper & modder docs

Web-first arcade hover-bike racer. Three.js + WebGPU + Rapier WASM. JetMoto homage with Wave Race water and light Mario Kart combat.

Build & Run

Spin up the dev server, learn the controls, and check what browsers and inputs are supported.

Get started

Bike stats, pickup behavior, race rules — what each archetype actually does on the track.

Bike stats

Author bikes, props, and tracks from JSON specs. Headless Blender builds the GLBs; the runtime auto-loads them.

Pipeline overview

In-Blender addon, panel-by-panel reference, scene conventions, and a blank-scene-to-playable-map tutorial.

Blender pipeline

Architecture rules, testing strategy, and the PR workflow for hacking on the engine itself.

Start here

Coordinate conventions, the window.__hover debug API, and the URL parameters the game accepts.

Conventions

This is the dev + modder-facing documentation. If you're trying to:

Run the game locally or wire up a controller → start in Build & Run.
Build your first track in Blender → Your first track — blank scene to playable map.
Go deeper on level-making → in-repo docs/level-making.md — reading order, which-doc-for-whom, and the two authoring workflows.
Make a new bike, prop, or track → Modding.
Hack on the engine itself → Contributing.
Look up a number (top speed, hover height, pickup behavior) → Gameplay.
Read the deep design docs → in-repo docs/ plan files (status.md, implementation-plan.md, product-plan.md, ADRs). This site links to them where relevant; it does not duplicate them.


Repo	unclemattmakes/king-tide
Live build	kingtide.unclemattmakes.com — pushes to `main` auto-deploy
Stack	TypeScript · Vite 8 · Three.js (WebGPU + WebGL2) · Rapier WASM · bitECS 0.4
Tooling	pnpm 10 · Vitest · Playwright · Biome 2 · Blender 5.1 (headless)
Hosting	Vercel