CrazyKarts: Rocket Rampage 🚀

A thrilling 3D racing game with rocket-powered combat, developed using Three.js and TypeScript. Experience the adrenaline of high-speed racing combined with explosive rocket battles in a procedurally generated world.

🎮 Game Features

• Procedurally Generated World

  • Infinite terrain with varying landscapes
  • Dynamic chunk loading for optimal performance
  • Roads, forests, and other environmental features

• Rocket-Powered Combat

  • Fire rockets from your vehicle
  • Realistic projectile physics with velocity inheritance
  • Explosive impacts and particle effects
  • Chain reactions with burning trees

• AI Companions

  • Two AI buddies that follow and assist you
  • Coordinated rocket attacks
  • Smart formation keeping
  • Dynamic pathfinding

• Opponent AI

  • Intelligent opponents that chase and evade
  • Dynamic behavior based on player position
  • Realistic collision avoidance
  • Respawn system for destroyed opponents

• Vehicle Physics

  • Realistic acceleration and deceleration
  • Dynamic steering with wheel rotation
  • Terrain-following vehicles
  • Collision detection and response

🛠️ Technical Implementation

The game was developed using modern web technologies and AI-assisted coding:

• Core Technologies

  • Three.js for 3D graphics
  • TypeScript for type-safe code
  • Vite for fast development and building
  • Tweakpane for runtime debugging

• AI-Assisted Development

  • Built with Cursor AI for enhanced productivity
  • Vibe coding sessions for creative problem-solving
  • Iterative improvements guided by AI suggestions
  • Natural language to code conversion

• Key Systems

  • Procedural world generation using simplex noise
  • Chunk-based terrain management
  • Physics-based vehicle movement
  • Particle systems for effects
  • Collision detection and response

🚀 Getting Started

1. Clone the repository
2. Install dependencies:

   pnpm install

3. Start the development server:

   pnpm dev

4. Open your browser to the displayed URL

🎮 Controls

• Movement

  • W/Arrow Up: Accelerate
  • S/Arrow Down: Brake/Reverse
  • A/Arrow Left: Turn Left
  • D/Arrow Right: Turn Right

• Combat

  • Space: Fire Rocket

🎨 Development Process

This game was developed using an AI-assisted workflow:

1. Initial Concept

   • Brainstormed with Cursor AI
   • Defined core gameplay mechanics
   • Planned technical architecture

2. Core Systems

   • Implemented vehicle physics
   • Created rocket combat system
   • Developed world generation

3. AI Features

   • Added companion AI
   • Implemented opponent behavior
   • Created dynamic pathfinding

4. Polish

   • Added visual effects
   • Improved performance
   • Enhanced gameplay feel

🤖 AI Development Experience

The development process was enhanced by Cursor AI:

• Code Generation

  • Natural language to TypeScript conversion
  • Complex system implementations
  • Bug fixing and optimization

• Problem Solving

  • Physics calculations
  • AI behavior algorithms
  • Performance optimization

• Iterative Improvement

  • Continuous feedback loop
  • Real-time code suggestions
  • Architecture optimization

📝 License

MIT License - feel free to use this code for your own projects!

🙏 Acknowledgments

• Three.js community for 3D graphics
• Cursor AI for development assistance
• All contributors and testers