MankyDanky/web-racing

MankyDanky/web-racing has 34 GitHub stars and 16 forks. GitHot measured 0 stars in 24 hours and 0 in 7 days. Last checked 2026-11-12 02:47 UTC. Last push 2026-08-25.

How these counts are measured

A 3D multiplayer racing web game made with Three.js, Peer.js, and Django

34 stars 16 forks

What you can do

Multiplayer Racing: Race against friends in real-time using WebRTC peer-to-peer connections
Physics-Based Driving: Realistic car physics with speed-dependent steering, suspension, and collision detection
Multiple Tracks: Different race tracks with unique layouts and obstacles
Checkpoint System: Race through gates to progress and track your lap time

Measured star growth

in 24h: 0
in 7 days: 0
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

Racez.io

A real-time multiplayer 3D racing game built with JavaScript and modern web technologies. Race with friends through various tracks, compete for the best time, and enjoy physics-based driving mechanics.

Play Now

Play Racez.io Online

Features

Multiplayer Racing: Race against friends in real-time using WebRTC peer-to-peer connections
Physics-Based Driving: Realistic car physics with speed-dependent steering, suspension, and collision detection
Multiple Tracks: Different race tracks with unique layouts and obstacles
Checkpoint System: Race through gates to progress and track your lap time
Leaderboard: Compete for the best times and see rankings
Party System: Create or join racing parties with simple code sharing
Mobile Support: Optimized for desktop and mobile with touch controls
Car Customization: Choose from various car colors

How to Play

Creating a Game

Visit the Racez.io website
Enter your name
Choose your car color
Click "Create Party"
Share the generated party code with friends
Select a track from the dropdown menu
Click "Start Race" when everyone is ready

Joining a Game

Visit the Racez.io website
Enter your name
Choose your car color
Enter the party code provided by the host
Click "Join Party"
Wait for the host to start the race

Controls

Desktop

W: Accelerate
S: Brake/Reverse
A: Turn left
D: Turn right
R: Reset car to last checkpoint

Mobile

Virtual Joystick: Steer the car (left side of screen)
Joystick Up: Accelerate
Joystick Down: Brake/Reverse
Joystick Left/Right: Turn

🧰 Technologies Used

Three.js: 3D rendering engine
Ammo.js: Physics engine (WebAssembly port of Bullet Physics)
PeerJS: WebRTC peer-to-peer connections
JavaScript: Core programming language
HTML5/CSS3: Frontend structure and styling
Python/Django: Backend server for matchmaking and party code management

⚙️ Backend Setup

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Required environment variables (the server will refuse to start without them):

Variable	Description
`SECRET_KEY`	Django secret key. Generate with `python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"`
`DEBUG`	Set to `True` only for local development
`ALLOWED_HOSTS`	Comma-separated list of allowed hostnames
`CORS_ALLOWED_ORIGINS`	Comma-separated list of frontend origins

The SQLite database (db.sqlite3) and the virtualenv are not tracked in git - they are created locally / by build.sh.