Suika Game 🍉

Welcome to Suika Game, a fun and addictive fruit-merging game! Combine identical fruits to create bigger ones and aim for the highest score. Inspired by the classic "Watermelon Game," Suika Game offers a delightful experience with physics-based gameplay, colorful visuals, and engaging mechanics.

---

📖 About the Project

Suika Game is a browser-based game developed using JavaScript and Matter.js. The game challenges players to strategically drop fruits, merge them, and create larger fruits while avoiding game-over conditions. It features responsive design, music, and customizable difficulty levels.

---

🚀 Features

• 🎮 Physics-Based Gameplay: Powered by Matter.js, every fruit drop is realistic and dynamic.
• 🍒 Fruit Fusion: Merge identical fruits to create new ones with higher scores.
• 🎵 Background Music: Enjoy relaxing music while playing.
• 📱 Responsive Design: The game adapts seamlessly to smaller devices.
• 🌟 Difficulty Settings: Choose from Easy, Normal, or Hard modes.
• 🏆 High Score System: Your best score is saved locally.
• ✨ Visual Effects: Particle animations for fruit fusions.
• 📊 Fruit Evolution Diagram: View all possible fruit combinations.

---

🖥️ Live Demo

You can play the game directly in your browser! Play Suika Game Now!

---

📂 Project Structure

SuikaGame/
├── index.html          # Main HTML file
├── styles.css          # Game styles
├── js/
│   ├── config.js       # Game configurations
│   ├── fruits.js       # Fruit logic
│   ├── particles.js    # Particle effects
│   ├── physics.js      # Physics setup with Matter.js
│   ├── ui.js           # User interface logic
│   └── game.js         # Main game logic
├── audio/
│   └── background.mp3  # Background music
└── images/
    ├── cherry.png      # Cherry fruit image
    ├── strawberry.png  # Strawberry fruit image
    └── ...             # Other fruit images

---

⚙️ How to Play

1. Click "Start Game" on the main menu.
2. Use your mouse (or touch on mobile) to position the fruit above the board.
3. Release the fruit to drop it onto the board.
4. Merge identical fruits to create larger ones!
5. Avoid letting the fruits stack above the red line.

---

📦 Installation

To run the game locally:

1. Clone this repository:

   git clone https://github.com/your-username/suika-game.git
   

2. Navigate to the project directory:

   cd suika-game
   

3. Open index.html in your preferred browser.

---

🛠️ Technologies Used

• HTML5
• CSS3
• JavaScript (ES6+)
• Matter.js - A 2D physics engine

---

🌟 Features in Development

The following features are planned for future updates:

• 🎨 Customizable themes (light/dark mode).
• 🥇 Online leaderboard for global high scores.
• 🔊 Sound effects for collisions and fusions.

---

🤝 Contributing

Contributions are welcome! Here's how you can contribute:

1. Fork the repository.
2. Create a new branch:

   git checkout -b feature-name
   

3. Make your changes and commit them:

   git commit -m "Add feature-name"
   

4. Push your changes:

   git push origin feature-name
   

5. Open a Pull Request on GitHub.

---

🖼️ Credits

Images:

All fruit images are custom-designed or sourced from free, royalty-free resources.

Libraries:

This project uses Matter.js for physics simulation.

---

📄 License

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