Skip to content

the911fund/neon-desert-outlaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

42 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽ๏ธ Neon Desert Outlaw

A neon-soaked, physics-driven desert racing game built with PixiJS and TypeScript.

License

๐ŸŽฎ Play

Play Online โ€” runs in any modern browser, desktop or mobile.

About

Neon Desert Outlaw is a top-down racing game set in a procedurally generated desert. Race through neon-lit outposts, drift across sand dunes, and compete against AI opponents โ€” all rendered with dynamic lighting, bloom effects, and physics-driven particle trails.

Features

  • Physics-based driving โ€” bicycle model with realistic friction, drift mechanics, and surface-dependent grip
  • Procedural world โ€” infinite desert generated with Poisson-disc sampling, chunked terrain streaming
  • Dynamic lighting โ€” headlights, neon glow, bloom post-processing
  • Multiple game modes โ€” Quick Race and Story Mode
  • AI opponents โ€” race against bots with distinct driving personalities
  • Mobile support โ€” touch controls with virtual joystick, responsive UI
  • Synthwave audio โ€” procedurally generated soundtrack with in-game music controls

๐Ÿ•น๏ธ Controls

Keyboard

Key Action
W / โ†‘ Accelerate
S / โ†“ Brake / Reverse
A / โ† Steer Left
D / โ†’ Steer Right
Space Handbrake
M Toggle Sound
Enter Start Race / Confirm
ESC Back to Menu

Mobile / Touch

  • Left joystick โ€” steer and accelerate (push up to go, tilt to steer)
  • B button โ€” brake
  • H button โ€” handbrake

๐Ÿ› ๏ธ Development

Prerequisites

  • Node.js 18+
  • pnpm (recommended) or npm

Setup

git clone https://github.com/the911fund/neon-desert-outlaw.git
cd neon-desert-outlaw
pnpm install

Commands

Command Description
pnpm dev Start dev server with HMR
pnpm build Production build to dist/
pnpm lint Run ESLint
pnpm typecheck TypeScript type checking
pnpm test Run unit tests (Vitest)

Tech Stack

  • Engine: PixiJS 8 (WebGL/WebGPU)
  • Language: TypeScript
  • Bundler: Vite
  • Testing: Vitest

๐Ÿ“ Project Structure

src/
โ”œโ”€โ”€ main.ts              # App entry point
โ”œโ”€โ”€ game/                # Game loop, input, config, race mode
โ”œโ”€โ”€ physics/             # Bicycle model, drift, surfaces, collisions
โ”œโ”€โ”€ world/               # Procedural terrain, chunks, obstacles
โ”œโ”€โ”€ rendering/           # Camera, lighting, particles, bloom
โ”œโ”€โ”€ vehicle/             # Vehicle entity, renderer, headlights
โ”œโ”€โ”€ ai/                  # Bot drivers and vehicles
โ”œโ”€โ”€ story/               # Story mode missions and dialogue
โ”œโ”€โ”€ ui/                  # HUD, minimap, menus, touch controls
โ””โ”€โ”€ utils/               # Math helpers, object pooling

License

ISC

About

๐ŸŽ๏ธ Neon Desert Outlaw โ€” High-fidelity 2D top-down driving game. PixiJS + TypeScript. Physics-driven, procedurally generated neon desert.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages