|
| 1 | +# 🍎 Fruity Frenzy 🧺 |
| 2 | + |
| 3 | +A classic arcade-style fruit-catching game built with Python. Dodge what you can't catch and aim for the high score! This game is a complete, standalone desktop application featuring an animated intro, sound effects, and persistent scoring. |
| 4 | + |
| 5 | + |
| 6 | +--- |
| 7 | + |
| 8 | +## ## Features |
| 9 | + |
| 10 | +* **Animated Intro Screen:** A fun GIF and background music greet you on launch. |
| 11 | +* **Dynamic Gameplay:** Catch multiple fruits falling at varying speeds. |
| 12 | +* **4-Way Movement:** Full control to move the basket up, down, left, and right. |
| 13 | +* **Life System:** Start with three lives, represented by hearts. Lose a life for each missed fruit! |
| 14 | +* **Persistent High Score:** The game saves your high score in a `highscore.txt` file. |
| 15 | +* **Sound Effects:** Includes background music and a satisfying sound for each catch. |
| 16 | +* **Standalone Executable:** Comes with instructions to bundle the entire game into a single `.exe` file for easy distribution. |
| 17 | + |
| 18 | +--- |
| 19 | + |
| 20 | +## ## 🛠️ Built With |
| 21 | + |
| 22 | +* **Python 3** |
| 23 | +* **Tkinter:** For the graphical user interface (GUI). |
| 24 | +* **Pygame:** For handling music and sound effects. |
| 25 | +* **Pillow (PIL):** For processing the animated intro GIF. |
| 26 | + |
| 27 | +--- |
| 28 | + |
| 29 | +## ## 🚀 Getting Started |
| 30 | + |
| 31 | +Follow these instructions to get a copy of the project up and running on your local machine. |
| 32 | + |
| 33 | +### ### Prerequisites |
| 34 | + |
| 35 | +Make sure you have **Python 3** installed on your system. You can download it from [python.org](https://www.python.org/downloads/). |
| 36 | + |
| 37 | +### ### Installation |
| 38 | + |
| 39 | +1. **Clone the repository:** |
| 40 | + ```bash |
| 41 | + git clone [https://github.com/your_username/FruityFrenzy.git](https://github.com/your_username/FruityFrenzy.git) |
| 42 | + cd FruityFrenzy |
| 43 | + ``` |
| 44 | + |
| 45 | +2. **Install the required Python packages:** |
| 46 | + ```bash |
| 47 | + pip install -r requirements.txt |
| 48 | + ``` |
| 49 | + *(You will need to create a `requirements.txt` file with the content below.)* |
| 50 | + |
| 51 | +3. **Add Assets:** |
| 52 | + Make sure the following asset files are placed in the root directory of the project: |
| 53 | + * `intro.gif` (The intro animation) |
| 54 | + * `music.mp3` (Background music) |
| 55 | + * `1.mp3` (The fruit catch sound effect) |
| 56 | + * `icon.ico` (The icon for the executable) |
| 57 | + |
| 58 | +--- |
| 59 | + |
| 60 | +## ## 🎮 How to Play |
| 61 | + |
| 62 | +To run the game from the source code, execute the following command in your terminal from the project's root directory: |
| 63 | +
|
| 64 | +```bash |
| 65 | +python FruitFrenzy.py |
0 commit comments