Outrun Dhaka
An arcade racer through Dhaka, after Horizon Chase Turbo. Race any of fifteen districts as a three-lap circuit, or run The Run: a knockout race across the whole city, from Dhanmondi at dusk to the Padma Bridge at dawn.
Runs in the browser. No install, no assets to download: the world, the music and the engine sounds are all generated in code, in about 2 MB.
Play
- Play now: https://hal0mg.github.io/outrun-dhaka/ (runs in your browser, nothing to install; Chrome or Edge works best).
- Windows: download
OutrunDhaka.exe from the latest release and run it. (Windows may warn that the file is unsigned: More info, then Run anyway.) Or build it yourself with npm run exe.
- Any browser: build it (below) and open
dist/index.html in Chrome or Edge. It is one self-contained file. Fonts load from Google Fonts when online.
- Dev server:
npm install, npm run dev, then open http://127.0.0.1:5173
Controls: ↑/W gas · ↓/S brake · ←→ steer · SPACE/B nitro · R music · ESC/P pause · F fullscreen. Gamepads work. On a phone, gas is automatic: two steer buttons on the left, brake and nitro on the right.
The game
- Circuit: any district, three laps, 24 cars. You start last with the field strung out ahead, so you pass a few at a time. Gold, silver and bronze times; your best time and medal are saved per race.
- The Run: 48 cars on one road through every district. Knockout gates thin the field at Shahbag, Kawran Bazar, Gulshan, Sadarghat, Mirpur and 300 Feet. About five minutes.
- Driving: corners push you wide, so the skill is the line you hold. Tap nitro to burn a charge (hold three), but nitro in a bend throws you wide. The verge and rails cost speed and grip. Rows of nitro lie across the road, and every eighth car you pass earns another charge.
- The road: rickshaws, CNGs, buses, police and RAB pickups, pedestrians and stalls. Nobody keeps to a lane. Anything you hit is flung off the road. Potholes, patches and litter that scatters when you drive through it; in the rain, puddles that splash, umbrellas and water beading on the car. On divided roads, stretches of ROAD WORKS push you onto the opposite carriageway, against oncoming traffic.
- The places: each district has its own time of night, weather, music and real landmarks (Jatiya Sangsad Bhaban, Ahsan Manzil, Baitul Mukarram, Shaheed Minar and more), plus the metro train on its viaduct, planes over the airport, kites and fireworks.
- Sound: original modern electronic music (future house, moombahton, melodic techno, UK garage, liquid drum & bass) on Bengali ragas, with tabla, bansuri and ektara as the hooks, a different track per district. Every car has its own modelled engine: the Supra's twin-turbo six, the Skyline's RB26 with its flutter, the Miata's unboosted four, the CNG's two-stroke, with turbo spool, whistle and blow-off. Around the road: horns, rickshaw bells, street sellers' calls, dogs and songs leaking from shop radios, busier in the busy districts.
- Cars: pick your car and colour on the race card before each race. Every car drives the same; only the body and the sound differ.
Dhanmondi → Shahbag → Manik Mia → Kawran Bazar → Hatirjheel → Gulshan → Old Dhaka → Sadarghat → Motijheel → Mirpur → Airport Road → 300 Feet → CTG Highway → Savar → Padma Bridge
Build
npm install
npm run build # dist/index.html, a single file
npm run artifact # also dist/outrun-dhaka.artifact.html (no document skeleton)
npm run exe # dist/OutrunDhaka.exe, a 2 MB Windows launcher (see below)
Built with three.js and Vite. Deployed as a static site (see render.yaml).
Windows exe
npm run exe builds dist/OutrunDhaka.exe: one 2 MB file with the game inside. It opens the game in its own Edge app window (no tabs or address bar), so there is no Electron and nothing to install: Edge ships with Windows 10 and 11 (Chrome is used if Edge is missing). It is built with the C# compiler that comes with Windows; the source is tools/launcher/Launcher.cs. Settings and best times are kept in %LOCALAPPDATA%/OutrunDhaka.
Optional recordings and models
The game ships with generated sound and buildings. If you add files, it uses them instead; any that are missing fall back to the generated version.
When using these, the build is a folder (dist/), not just one file.
Code map
src/world/ track geometry, districts (stages.js), chunk streaming, props, landmarks, textures, sky, road shadersrc/game/ driving model (player.js), races and rivals (race.js), traffic, pedestrians, instanced cars (fleet.js), ambience, showreel (attract.js), weather, camerasrc/audio/ synthesised engines and effects, the music sequencersrc/ui/ HUD, menus, the Dhaka map
AI driver
The game's driving model and race also run with no graphics, in Node: a full three-lap race against the field takes about 120 ms (15 ms alone). sim/ wraps it as an environment for training AI drivers, and ml/ trains them with reinforcement learning (PPO, via Stable-Baselines3).
以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗
