mirror of
https://github.com/pepaskopec-blip/Snake-Pygame-.git
synced 2026-10-27 16:24:30 +00:00
02d2d92321Added detailed description, features, installation instructions, controls, and project structure for the Snake game.
41 lines
1.8 KiB
Markdown
41 lines
1.8 KiB
Markdown
# 🐍 Snake (Pygame Edition)
|
|
|
|
A colorful, feature-rich Snake game written in **Python** using the **Pygame** library. This version elevates the classic arcade experience with modern mechanics, a progression system, and local multiplayer.
|
|
|
|
## 🌟 Key Features
|
|
|
|
* **Game Modes:** Play solo or go head-to-head in Duo mode with a friend.
|
|
* **Smart AI:** Challenge yourself against an optional AI-controlled opponent for Player 2.
|
|
* **Deep Customization:** Adjust difficulty levels, map sizes, and obstacle density to suit your playstyle.
|
|
* **Dynamic Gameplay:** Various fruit types with unique scores/effects and customizable "bad food" behavior.
|
|
* **Progression System:** Unlockable skins, trails, visual effects, SFX packs, and music styles to personalize your experience.
|
|
* **Persistence:** Your high scores and settings are automatically saved and loaded via JSON and text files.
|
|
|
|
## 🛠️ Installation & Setup
|
|
|
|
### Requirements
|
|
* **Python:** 3.10 or newer
|
|
* **Pygame:** 2.6.1 or newer
|
|
|
|
### Quick Start
|
|
1. **Install dependencies:**
|
|
`pip install pygame`
|
|
2. **Launch the game:**
|
|
`python snake.py`
|
|
|
|
## 🎮 Controls
|
|
|
|
| Action | Player 1 | Player 2 (Human) |
|
|
| :--- | :--- | :--- |
|
|
| **Movement** | `W`, `A`, `S`, `D` | Arrow Keys |
|
|
| **Menu Navigation** | Arrows / `W`, `S` + `Enter` | — |
|
|
| **Settings** | Mouse Click Support | — |
|
|
|
|
## 📁 Project Structure
|
|
|
|
* `snake.py`: The core game engine containing all logic and rendering.
|
|
* `snake_settings.json`: Stores your personalized game configuration and progress.
|
|
* `snake_high_score.txt`: Keeps track of your highest achieved scores.
|
|
|
|
---
|
|
*Note: Make sure audio is enabled in your system to enjoy the full experience with custom SFX and music styles. If the game window does not open, please verify your Python and Pygame installation.*
|