Skip to content

Commit 3edd667

Browse files
committed
added readme file and screenshot
1 parent 9992571 commit 3edd667

File tree

2 files changed

+120
-1
lines changed

2 files changed

+120
-1
lines changed

README.md

Lines changed: 120 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,120 @@
1-
# PythonSnakeGame
1+
# Python Snake Game
2+
3+
🐍 **Python Snake Game**
4+
A simple yet fun implementation of the classic Snake game built using Python's tkinter GUI library. Eat the yellow food, grow longer, and try not to crash into the walls or yourself!
5+
6+
---
7+
8+
## 🎮 Game Features
9+
- 🧱 **Grid-based movement**
10+
- 🍎 **Randomly spawned food**
11+
- 🐍 **Snake grows with every food eaten**
12+
- 💀 **Collision detection with walls and self**
13+
- 🏁 **Game over screen**
14+
- ⌨️ **Keyboard arrow controls**
15+
- 🧪 **Written in pure Python with no external dependencies**
16+
17+
---
18+
19+
## 🛠 Requirements
20+
- **Python 3.x** (recommended: 3.6+)
21+
- **tkinter** (included with most standard Python installs)
22+
23+
---
24+
25+
## ▶️ How to Run
26+
27+
1. Clone the repository:
28+
```bash
29+
git clone https://github.com/yourusername/PythonSnakeGame.git
30+
cd PythonSnakeGame
31+
32+
```markdown
33+
# Python Snake Game
34+
35+
🐍 Python Snake Game
36+
A simple yet fun implementation of the classic Snake game built using Python's tkinter GUI library. Eat the yellow food, grow longer, and try not to crash into the walls or yourself!
37+
38+
---
39+
40+
## 🎮 Game Features
41+
- 🧱 **Grid-based movement**
42+
- 🍎 **Randomly spawned food**
43+
- 🐍 **Snake grows with every food eaten**
44+
- 💀 **Collision detection with walls and self**
45+
- 🏁 **Game over screen**
46+
- ⌨️ **Keyboard arrow controls**
47+
- 🧪 **Written in pure Python with no external dependencies**
48+
49+
---
50+
51+
## 🛠 Requirements
52+
- **Python 3.x** (recommended: 3.6+)
53+
- **tkinter** (included with most standard Python installs)
54+
55+
---
56+
57+
## ▶️ How to Run
58+
59+
1. Clone the repository:
60+
```bash
61+
git clone https://github.com/yourusername/PythonSnakeGame.git
62+
cd PythonSnakeGame
63+
```
64+
65+
2. Run the game:
66+
```bash
67+
python snake_game.py
68+
```
69+
Replace `snake_game.py` with the actual filename if different.
70+
71+
---
72+
73+
## 🎯 How to Play
74+
- Use the arrow keys to move:
75+
- ⬆️ **Up**
76+
- ⬇️ **Down**
77+
- ⬅️ **Left**
78+
- ➡️ **Right**
79+
- Eat the yellow food to grow longer.
80+
- Avoid crashing into walls or your own body.
81+
- The game ends when a collision occurs.
82+
- Your score is displayed at the top.
83+
84+
---
85+
86+
## 🖼️ Screenshot
87+
![alt text](image.png)
88+
89+
---
90+
91+
## 📁 Project Structure
92+
```plaintext
93+
PythonSnakeGame/
94+
95+
├── snake_game.py # Main game logic and GUI
96+
├── README.md # Project documentation
97+
98+
```
99+
100+
---
101+
102+
## 🧠 Future Improvements (Ideas)
103+
- Add difficulty levels (e.g., speed increases over time)
104+
- Wall wrap mode (snake continues through walls)
105+
- Sound effects and background music
106+
- High score tracking and leaderboard
107+
- Pause and resume functionality
108+
109+
---
110+
111+
## 📄 License
112+
This project is licensed under the **MIT License**.
113+
114+
---
115+
116+
## 🙌 Credits
117+
Created with 💚 using Python and Tkinter.
118+
Inspired by the classic Nokia Snake game.
119+
120+

image.png

20.2 KB
Loading

0 commit comments

Comments
 (0)