🏎️ Top-Down 2D Car Engine 🏁

Arcade Driving Physics & Push-Behind Steering Demo

Push to throttle, slide to drift, and master the corners. A physics-driven arcade driving sandbox built for web and mobile.

📝 Introduction

Nailing that sweet spot between snappy arcade responsiveness and satisfying drift momentum in 2D top-down games is notoriously tricky. Most driving games either feel on rails or like you're steering a soap bar on ice.

Top-Down 2D Car Engine is an interactive sandbox and open-source engine built from scratch to solve that. It introduces an innovative Rear-Touch Push Steering system designed for modern touchscreens (and mouse drag), paired with a dynamic tire friction and drift physics model.

This page runs the playable web demo—take the cars for a spin, test their limits, kick out the back end on sharp turns, and check out the real-time telemetry!

✨ What It Is & How It Works

Experience an arcade-style driving model featuring:

  • Intuitive Push-Behind Steering: Control your car with a single finger or mouse drag behind the rear bumper—push forward to accelerate, slide laterally to swing the tail and steer, or push through the car to brake and reverse.
  • Dynamic Drift & Tire Smoke: A tailored friction decay model with lateral slip angle calculation, tire skid marks, and expanding smoke particles as you break traction.
  • Vehicle Showroom & 5 Tuned Presets: Test 5 distinct car classes (Standard, Muscle, Sports, Drifter, and Truck), each individually balanced across Speed, Acceleration, and Handling. Swap cars on the fly without resetting your run!
  • Dynamic Chase Camera: Smooth follow camera with speed-proportional forward lookahead, screen padding, and car-up rotation.
  • Live Telemetry HUD: Real-time digital speedometer (km/h & px/s), G-force estimator, slip angle gauge, drift notification, and performance metrics.

🎮 Controls

  • Touch & Mouse Drag (Recommended): Tap/click and drag behind the rear bumper to steer and push forward. Push forward ahead of the car to brake / reverse.
  • Keyboard (Desktop):
    • W / Up Arrow: Throttle
    • S / Down Arrow: Brake & Reverse
    • A / D or Left / Right: Steer
    • Space: Handbrake / Skid
    • R: Reset car position to start
  • Car Selector: Click or tap the "Choose Car" button in the top HUD to switch between vehicles anytime.

🔓 100% Free & Open Source — Build Your Own Game!

This game is a playable demo, and the entire underlying engine and codebase are completely free, open source, and unencumbered (MIT License).

Whether you want to build a retro top-down racer, a courier delivery game, a getaway driver thriller, or a micro-machines arena battler:

  • Build It Yourself: The core physics engine is modular, headless, and cleanly separated from the UI and demo layers. Grab the physics loop, drop in your own tracks, sprites, and gameplay rules.
  • Build With AI Tools: The repository comes pre-loaded with curated AI engineering prompts, architecture rules, and coordinate invariants (docs/AGENTS.md). You can drop the repo into Google Antigravity IDE, Cursor, Claude Code, GitHub Copilot, or ChatGPT and immediately prompt it to create tracks, custom cars, multiplayer networking, or brand-new game modes without breaking physics!

👉 Explore the source code on GitHub: https://github.com/ishanmanjrekar/topdown-2d-car-engine

🤖 Tools Used & Tech Stack

This project was created and compiled using:

  • Google Antigravity IDE & Gemini
  • React 19 & TypeScript
  • Vite 6 (Lightning-fast bundling & Itch packaging)
  • HTML5 Canvas 2D Context (High-performance multi-layer rendering)
  • Capacitor 7 (Cross-platform native mobile compilation)

☕ Support / Follow

Got feedback, drift physics tuning ideas, or questions about using the engine for your game? Leave a comment below!

More information