Skip to content

quimeyruffa/Marble-Race

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Marble Race

Marble Race is an exciting game built with Three.js and React, incorporating libraries like Zustand for global state management and react-three for physics. Players navigate through levels filled with random obstacles, aiming to reach the finish line where a delicious hamburger awaits as a reward.

Features

  • Three.js and React Integration: Leveraging the power of Three.js for 3D graphics within a React environment for smooth and efficient UI interactions.
  • Global State Management: Zustand library ensures efficient management of global states, providing seamless communication between components.
  • Dynamic Levels: Each level offers a unique experience with randomly generated obstacles, keeping the gameplay fresh and engaging.
  • Interactive Physics: Utilizing react-three for physics simulation, providing realistic marble movement and collision interactions.
  • Reward System: Players are motivated to complete levels by the promise of a delicious hamburger waiting for them at the finish line.

Setup

  1. Clone the Repository:

    git clone https://github.com/yourusername/marble-race.git
    
  2. Install Dependencies:

    cd marble-race
    npm install
    
  3. Run the Application:

    npm start
    
  4. Open in Browser: Open your web browser and navigate to http://localhost:3000 to start playing Marble Race!

Contributing

Contributions are welcome! Feel free to submit bug reports, feature requests, or pull requests to help improve Marble Race and make it even more enjoyable for players.

Credits