Motion-Controlled 3D Game 🎮🍉

Welcome to the Motion-Controlled 3D Game! This project combines cutting-edge technology with fun gameplay. Using PoseNet for real-time hand tracking and Three.js for 3D rendering, this browser-based game allows you to slice fruits and dodge bombs—all through your webcam. Dive into a world where your hands control the action!

Table of Contents

• Features
• Technologies Used
• Installation
• Gameplay
• How to Play
• Contributing
• License
• Releases
• Contact

Features

• Real-time Hand Tracking: Experience responsive gameplay as PoseNet detects your hand movements.
• 3D Rendering: Enjoy vibrant graphics powered by Three.js.
• Interactive Gameplay: Slice fruits and avoid bombs using simple gestures.
• Webcam Compatibility: Play directly in your browser without additional software.
• Fun and Educational: Learn about gesture recognition and computer vision while having fun.

Technologies Used

This project utilizes a variety of technologies to deliver an engaging experience:

• JavaScript: The core language for game logic and interactivity.
• Three.js: A 3D library that makes WebGL easier to use.
• PoseNet: A machine learning model for real-time hand tracking.
• TensorFlow.js: A library for machine learning in JavaScript.
• WebGL: A web standard for rendering 3D graphics.

Installation

To get started, you need to clone the repository and run the game locally. Here’s how:

1. Clone the repository:

   git clone https://github.com/omana1/Motion-controlled-3D-game.git

2. Navigate to the project directory:

   cd Motion-controlled-3D-game

3. Open the index.html file in your web browser.

4. Ensure your webcam is enabled for hand tracking.

Gameplay

In this game, your objective is to slice as many fruits as possible while avoiding bombs. The game tracks your hand movements, allowing you to interact with the game environment.

Game Mechanics

• Slicing Fruits: Move your hand to slice fruits that appear on the screen.
• Avoiding Bombs: Be careful not to slice the bombs, as they will deduct points.
• Scoring: Each fruit sliced adds to your score. Try to beat your high score!

How to Play

1. Start the Game: Open the game in your browser.
2. Enable Webcam: Allow the game to access your webcam.
3. Slice Fruits: Use your hands to slice fruits as they appear.
4. Avoid Bombs: Keep an eye out for bombs and avoid slicing them.
5. End Game: The game ends after a set time or if you hit too many bombs.

Tips for Success

• Practice makes perfect. Get familiar with the hand movements.
• Keep your hands within the camera's view for better tracking.
• Stay focused on the screen to react quickly.

Contributing

We welcome contributions! If you want to help improve the game, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or fix.
3. Make your changes and commit them.
4. Push to your branch.
5. Create a pull request.

Please ensure your code follows the project's coding standards and includes relevant tests.

License

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

Releases

You can find the latest releases of the Motion-Controlled 3D Game here. Download the latest version and enjoy the game!

Contact

For any questions or feedback, feel free to reach out:

• Email: [email protected]
• GitHub: omana1

Thank you for checking out the Motion-Controlled 3D Game! We hope you enjoy slicing fruits and dodging bombs. Happy gaming!