A high-speed battle-race multiplayer browser game where 2-8 players race through an intersecting figure-8 course while engaging in melee combat using mobility abilities.

Wreckless is a low-poly browser-based FPS that combines high-speed racing with tactical melee combat. Players choose from three distinct mobility classes and compete to reach the finish line while using special abilities to knock out opponents and gain speed advantages.

• 🏁 Race-Fight Hybrid: Progress through checkpoints while engaging in strategic combat
• ⚡ High-Mobility Classes: Three unique classes with distinct movement abilities
• 🎯 Tactical Combat: Cone-sweep melee attacks with blocking and parry mechanics
• 🌐 Real-time Multiplayer: 2-8 player online matches with 60Hz tick rate
• 📱 Accessible: Runs on low-spec devices with 60fps performance target

• WASD - Movement
• Space - Jump
• Shift - Slide
• LMB - Melee Attack
• RMB - Block
• E - Class Ability
• Esc - Menu

• Node.js 18 or higher
• npm or yarn package manager
• Modern web browser with WebGL2 support

1. Clone the repository

   git clone https://github.com/yourusername/wreckless.git
   cd wreckless

2. Install dependencies

   # Install root dependencies
   npm install
   
   # Install client dependencies
   cd client
   npm install
   
   # Install server dependencies
   cd ../server
   npm install

1. Start the development server

   # In the server directory
   cd server
   npm run dev

2. Start the client development server (in a new terminal)

   # In the client directory
   cd client
   npm run dev

3. Open your browser Navigate to http://localhost:5173 to play the game

# Build the client
cd client
npm run build

# Start production server
cd ../server
npm start

wreckless/
├── client/                 # Frontend Three.js application
│   ├── src/
│   │   ├── controller.ts   # Input handling
│   │   ├── physics.ts      # Rapier.js physics integration
│   │   ├── main.ts         # Application entry point
│   │   ├── kits/           # Character class abilities
│   │   ├── systems/        # Game systems (checkpoints, laps)
│   │   ├── track/          # Track generation and management
│   │   └── hud/           # UI and HUD components
│   └── public/            # Static assets
├── server/                # Node.js multiplayer server
├── docs/                  # Project documentation
│   ├── PRD.md            # Product Requirements Document
│   └── *.md              # Development logs and specs
└── README.md             # This file

1. Choose Your Class: Select from Blast-Jumper, Grapple-Swinger, or Blink-Dasher
2. Race Through Checkpoints: Navigate the figure-8 course hitting momentum pads
3. Combat Strategy: Use melee attacks to knock out opponents and gain speed buffs
4. Mobility Mastery: Master your class ability for optimal traversal and combat
5. Victory Conditions: First to finish line OR furthest progress when timer expires

Spawn → Checkpoint A (Momentum Pad) → Checkpoint B (Combat Arena) → Checkpoint C (Vertical Climb) → Finish Gate

• Target FPS: 60 fps on low-spec laptops
• Physics Frame Budget: ≤ 2ms
• Triangle Budget: ≤ 50k total
• Texture Resolution: 256px
• Network Budget: ≤ 50 KB/s per client

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Follow the Three.js best practices outlined in the project
• Use TypeScript for type safety
• Maintain 60fps performance target
• Test multiplayer functionality locally before submitting PRs

The game includes built-in performance monitoring:

• FPS counter in development mode
• Network latency display
• Physics frame time tracking
• Memory usage monitoring

• Grapple physics may be unstable on very high ping connections
• Mobile touch controls are not yet implemented
• Audio system is placeholder-only in current prototype

• Basic movement and physics
• Checkpoint system
• Class abilities implementation
• Multiplayer synchronization
• Art and audio pass
• Balance testing

• Parry mechanic refinement
• Additional character classes
• Spectator mode
• Replay system
• Tournament bracket system

This project is licensed under the MIT License - see the LICENSE file for details.

• Three.js community for the excellent 3D library
• Rapier.js for robust physics simulation
• Freesound.org for audio assets
• Mixamo for character animation rigs
• Built with assistance from Cursor AI

For questions, bug reports, or feature requests:

• Open an issue on GitHub
• Check the PRD for detailed game design
• Review development logs in the docs/ directory

Happy Racing! 🏎️💥