swastikk-drive

A small driving game that runs in the browser. It opens straight into the game and the main road is a closed loop, so you can keep going for as long as you like.

Off the loop there is a stunt park with a mega ramp and a ring of fire, a bowling lane you play with the car, a UFO field and a volcano. There are nine missions, a timed lap, day and night, and changing weather.

Cars and the Garage

Open Menu, then Garage (it also opens itself the first time you play). There are six cars — Aster (free, balanced), Volt GT, Phantom, Kestrel, Ridgeback and Mamba — each with real differences in top speed, acceleration, grip and steering feel, not just paint. Aster is free; the other five are unlocked with coins earned in-game (see below). Pick a paint color and a name while you're in there; both are remembered.

Coins

Coins come from playing, not from a store:

Action	Coins
Complete a mission	50
Finish a timed lap	10 (30 if it's a new best)
Complete a lap on a drawn circuit	10

Cars cost 150–600 coins. The Garage shows "Buy · price" on anything you haven't unlocked yet; clicking it spends the coins and switches you to that car in one step, or tells you how many more coins you need.

Stunts

• Every jump scores: air time, height and distance, plus 360 spins, flips and barrel rolls. Land on four wheels to bank it; land on your roof and it's gone ("BAILED"). Clean landings within five seconds of each other build a combo multiplier, up to x5. Every 1,000 points banked pays 5 coins.
• Ring of fire (stunt park): jump the mega ramp through it for +800, or +1,500 for a bullseye through the middle, paid when you land clean. Back-to-back passes build a streak; fly past it and you're told how close you were.
• Ramp Rush (ramp yard, off the side road): hoops hang over the three ramps. Clear one to start the clock, clear all three for gold (10 s), silver (16 s) or bronze (25 s). A board in the yard shows your best time and medal; a new medal pays coins.
• Bowling (stunt park): a five-frame game, two rolls a frame. Fallen pins are swept before your second roll; strikes and spares score with their bonus rolls. The board shows the frames and your best game; every game pays coins.

Bests are saved in your browser.

Radio

Press T (or Menu, then Radio) to tune through three stations, then off: 88.6 Lo-fi Drive, 94.2 Sunset Wave and 101.7 Night Jazz. The music is written live in the browser (assets/radio.js): each song picks a key, tempo and chord progression and plays for about three minutes, so there are no music files and nothing to license.

Draw your own track

Open Menu, then "Draw track". Freehand-draw a closed loop on the screen; it gets checked (does it close up, does it cross itself, is any corner too sharp) and, if it's valid, built into a real drivable track — asphalt, a bit of scenery around it, lap counting — somewhere off on its own away from the main map. The same button becomes "Go to track" once you have one, and "Back to world" while you're on it. The Laps option (1, 2, 3, 5 or 10) in the draw panel is the race's lap count. Pressing GO on your own starts a real race on the circuit: grid, start lights, then exactly that many laps. The lap counter only advances when you drive through every checkpoint gate in order and in the right direction and then cross the start/finish line; skipping a gate, cutting across, reversing over the line or an impossibly fast lap are not counted, and driving the wrong way shows WRONG WAY. In a room, the host's lap setting is the one that applies and it is frozen once the countdown starts. See ROADMAP.md for what is still missing (saved-circuit list, etc.).

Drawn venues come in 14 sceneries plus City and Moon (dark sky, lower gravity). Each is decorated all the way round the lap, not just at the start, from assets/venue-decor.js: flags, banner boards, lamps, corner chevrons, cones and 300/200/100 boards everywhere, plus per-theme sets (snowbanks, snow-capped pines, ice and cabins for snow; cacti and red mesas for desert; flowers, fences and round trees for green themes; a skyline and billboards for the city; craters, crystals, beacons and planets for the Moon). Placement is seeded (same track + seed = same scenery), kept clear of the road, the barriers, each other and the start area. The road, barriers and the start/finish area (a gantry square across the road at the line, a staggered grid that follows the track) are built at once when you press GO; the scenery streams in over the next frames, and every prop set is cut into 160 m cells that are culled and drawn only within a distance that suits their size.

Controls

Key	Does
W A S D or arrows	drive
Space	handbrake
Shift	boost
H	horn
T	FM radio: cycle stations / off
O	Settings: sound mix (master, engine, effects, music), radio, graphics, display, all controls
C	change camera
L	time a lap
B	fastest laps
M	map
N	day or night
R	reset the car

On a phone it shows big on-screen steering, gas, brake and boost. Landscape works best. Settings → Phone controls picks Steering: Buttons or Gyro (tilt) (gyro puts brake under the left thumb and gas under the right), the button size (small / medium / large), and gyro sensitivity, dead zone, smoothing, invert and a Centre button with a live steering meter. Menu → Full screen (or the first tap on Android) goes full screen; on iPhone, Share → Add to Home Screen opens it without browser bars.

Phone as a controller

In a room, every player (host or guest) has Connect phone in the room panel. It shows that player's own QR code; the link carries the room, the player id and a random secret token made for that player, and the game only obeys phone packets that match all three, so one phone can only ever drive its own player. The panel shows WAITING FOR PHONE / CONNECTED / CONTROLLER DISCONNECTED, the keyboard keeps working, and if the phone stops sending for a second its input goes neutral so the throttle never sticks.

Racing friends

Open Menu, then Room. Create a room, or type a code someone sent you, and up to eight drivers share it. You see each other as see-through ghost cars — built with whichever car they actually picked in the Garage, not a generic default — with a name tag above them, so nothing collides. Anyone in the room can hit Start race; everyone's countdown is synchronized to the same shared clock, so 3, 2, 1 lands together instead of drifting by each person's own connection speed. One lap around the loop, then finish times show for everyone. Ping to each other player shows in the room list. Whoever's been in the room longest can remove another player with the × next to their name. An invite link looks like ?room=CODE.

Rooms run on a Cloudflare Worker with one Durable Object per room code (see worker/). Each player sends their car pose about ten times a second and nothing is stored. Set the room server address in assets/net-config.js. Add ?net=local to link two tabs on one machine without any server.

Run it

It is plain HTML and JavaScript, so any static server works:

python3 -m http.server 8000

Then open http://localhost:8000. Three.js r128 and cannon.js 0.6.2 load from cdnjs.

The racing friends feature needs the room server. Start it with cd worker && npm install && npm run dev (port 8787). Deploy it with npm run deploy (see worker/README.md).

Cloudflare architecture

The game is static HTML and JavaScript on Vercel. Everything shared between players runs on Cloudflare, in worker/:

Browser ──HTTPS──> Cloudflare Worker ──> D1 (race, daily, typing boards; shared tracks)
   │                     │
   └──WebSocket──────────┴──> Durable Object "RaceRoom", one per room code ──> up to 8 players + phone controllers

• Workers (worker/src/index.ts): the API and router. Checks the origin, validates every request, adds CORS for the game's domains.
• Durable Objects (worker/src/room.ts): one room per code. Holds the sockets, caps rooms at 8 drivers, stops one player posing as another, rate limits senders (60/s, bursts of 120) and drops malformed or impossible messages (teleports, bad finish times).
• WebSockets: poses 6 to 20 times a second per player, events as they happen. Nothing per frame goes over HTTP.
• D1 (worker/src/boards.ts, worker/src/tracks.ts, worker/migrations/): leaderboards with rankings computed on the server, and drawn tracks behind short links (/track/ab12cd34). A finished race writes one row.
• R2, Turnstile, Queues, KV, Workers AI: not used. A shared track is about 2 KB and fits in D1; R2 would also need an R2 subscription added in the dashboard. See /architecture for the reasons in full.

Local: cd worker && npm install && npx wrangler d1 migrations apply skr-db --local && npm run dev, then serve the repo root on port 8000. Deploy: npx wrangler d1 migrations apply skr-db --remote && npm run deploy. Tests: npm test (relay, needs the dev server), node --test test/room-net.test.mjs, and node scripts/track-check.mjs from the repo root for drawn-track geometry.

Cloudflare free tier

Checked against Cloudflare's own pages on 2026-10-20 (links in worker/FREE-TIER.md). Re-check before relying on them.

Service	Purpose	Free allocation	Expected use	At the limit
Workers	API, routing	100,000 requests/day, 10 ms CPU each	1 per room join, finish, board view or share	requests fail until 00:00 UTC
Durable Objects	race rooms	100,000 requests/day, 13,000 GB-s/day	1 per socket, incoming messages count 20:1	room joins and messages fail until reset
D1	boards, shared tracks	5M rows read/day, 100k rows written/day, 5 GB	1 row written per finish or new share; a board view reads that day's rows once	not stated on the pricing page
R2	(not used)	10 GB-month, 1M Class A + 10M Class B ops/month	none	n/a
Turnstile, Queues, KV, Workers AI	(not used)	see worker/FREE-TIER.md	none	n/a

Files

• index.html the page, HUD and styles
• assets/game.js the whole game
• ROADMAP.md what's done, what's in progress, and what's deliberately not built yet
• MULTIPLAYER.md how the room/ghost system works under the hood