Turbo Smash 3D — Kart Battle Arena Game

System Requirements

• Any modern web browser with WebGL support (Chrome, Firefox, Edge, Safari — latest versions recommended)
• No Node.js, npm, or build tools required to run the game
• Internet connection required on first load (for CDN-hosted Three.js library and Google Fonts)

Option 1 — Quick Run (No Setup Required)

1. Extract the downloaded ZIP/RAR file to any folder on your computer.
2. Locate the index.html file inside the extracted folder.
3. Double-click index.html to open it directly in your default browser.
4. The game will load and run immediately — no server or installation needed.

Option 2 — Run via Local Server (Recommended for Development)

Running through a local server avoids browser restrictions on some features and mirrors production behavior more closely.

Using VS Code:

1. Open the extracted project folder in VS Code.
2. Install the Live Server extension (if not already installed).
3. Right-click index.html → Open with Live Server.
4. The game will open automatically in your browser at http://localhost:5500 (or similar).

Using Python (alternative):

1. Open a terminal in the project folder.
2. Run: python -m http.server 8000
3. Open http://localhost:8000 in your browser.

Option 3 — Deploy to a Live Hosting Platform

Since this is a static single-file HTML application, it can be deployed instantly to any static hosting service:

1. Create a free account on Vercel, Netlify, or GitHub Pages.
2. Upload the project folder (or connect your GitHub repo).
3. Deploy — no build command or environment variables are required.
4. Your game will be live at a public URL within seconds.

Notes

• All game assets (audio, models, effects) are generated procedurally in-code — there are no external asset files to configure or link.
• The game auto-detects desktop vs. mobile and switches between keyboard controls and touch controls accordingly.
• No API keys, environment variables, or backend configuration are required.

Getting Started

1. Open the game in your browser (via index.html or the hosted live URL).
2. On the title screen, select your Arena — Desert Dunes, Night City, Jungle Rush, Snow Peak, or Volcano Core.
3. Select a Difficulty level — Easy, Medium, or Hard — this controls bot speed, aim accuracy, and aggression.
4. Select a Time Limit — 1:00 Sprint, 2:00 Standard, 3:00 Extended, 5:00 Marathon, or No Limit.
5. Click Battle Now to start the match. A 3-second countdown will begin before gameplay starts.

Controls

Accelerate / Reverse

• Desktop: Arrow Up/Down or W/S
• Mobile: Virtual joystick (up/down)

Steer

• Desktop: Arrow Left/Right or A/D
• Mobile: Virtual joystick (left/right)

Fire Weapon

• Desktop: Spacebar or Enter
• Mobile: 🔫 Fire button

Boost

• Desktop: Shift
• Mobile: ⚡ Boost button

Core Gameplay Loop

• Drive around the arena and collect glowing weapon pickups (Machine Gun, Triple Bomb, Nuke Missile, Land Mine, or Shield).
• Engage AI bots in combat — each weapon has a different range, damage pattern, and use case.
• Drive over boost pads (glowing floor tiles) or use your boost meter to gain speed bursts.
• Track your kills, rank, and health via the HUD (top-left health bar, live leaderboard, minimap).
• Eliminated karts (yours or bots') respawn automatically after a short delay.
• When the timer expires, a results screen shows your final rank and the match winner.

Expected Output

• Smooth 3D rendering at interactive frame rates in any WebGL-capable browser.
• Real-time HUD updates: health, kill count, timer, weapon status, speed, leaderboard, and minimap.
• Procedurally generated sound for engine, weapons, explosions, and pickups — audible immediately, no loading delay.
• A Victory or Defeat screen with kill stats and match ranking once the timer ends.

System Requirements

Operating System

• Windows 10/11, macOS 11+, Linux (any distro with a modern browser), Android 9+, or iOS 14+

Browser (Required)

• Chrome 90+, Firefox 88+, Edge 90+, or Safari 14+ (WebGL 1.0/2.0 support required)

Hardware

• Processor: Dual-core 2.0 GHz or higher
• RAM: 4 GB minimum (8 GB recommended for smoother multi-bot battles)
• Graphics: Any GPU with WebGL support (integrated graphics sufficient; dedicated GPU recommended for consistently high frame rates)
• Storage: Under 5 MB (single-file HTML application, no installation footprint)

Network

• Internet connection required on first load (to fetch Three.js and Google Fonts from CDN)
• No connection required after initial load if assets are cached, though a live server/hosting connection is otherwise assumed

Mobile-Specific

• Touchscreen device with landscape orientation support (a rotate prompt appears automatically on portrait phones)