Skip to content

Commit 6090184

Browse files
Create readme.md
1 parent c348de6 commit 6090184

File tree

1 file changed

+65
-0
lines changed

1 file changed

+65
-0
lines changed

Fruit Frenzy/readme.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
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

Comments
 (0)