Skip to content

xcrap/micromachines

Repository files navigation

MicroMachines

A fun and exciting car racing game built with vibe coding, no actual coding was harm during the creation of this experiment.

Description

MicroMachines is an attempt to revive an old racing game where players can drive cars around various tracks, compete against AI opponents, and challenge their racing skills. The game focuses on fast-paced racing action with simple yet engaging mechanics.

TODO Priority

  • (*) Fix Trailing in top of decoration elements, should render only on top of ground/track and not hills, trees, etc
  • (*) Make Drift with Spacebar a real drift and not a break, reduce left right steering for more realistic driving.
  • () Increase the height to look more a terrain, maybe add some bumps to the track itself?
  • () Add Physics to the car so he can jump and drift.
  • () Add Sound Effects
  • () Fix Bugs
  • () Remove non used code
  • () Improve performance.

TODO Long Term

  • Multiple race tracks with different difficulties
  • Various car models with unique handling characteristics
  • Single player mode against AI opponents
  • Local multiplayer support
  • Customizable cars and racing settings
  • Physics-based driving mechanics
  • Dynamic weather effects

Installation

Prerequisites

  • Node.js (v14 or higher)
  • Modern web browser with WebGL support

Setup

# Clone the repository
git clone https://github.com/yourusername/micromachines.git

# Navigate to project directory
cd micromachines

# Install dependencies
bun install

# Start the game
bun run dev

How to Play

Launch the game and navigate through the menu to select your preferred game mode, track, and vehicle. The game supports both keyboard controls and gamepads.

Controls

  • Arrow keys/OPQA: Drive the car
  • Space: Handbrake
  • C: Change View (Control with Mouse)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages