update README with detailed project description

README.md

@@ -1,2 +1,63 @@
-# Snake-Pygame-
+🐍 Snake (Pygame Edition)
-Snake (Pygame)  A colorful, feature-rich Snake game  built in Python. It features Solo and Duo modes with an optional AI opponent. Players can customize difficulty, map sizes, obstacle density, and fruit effects. Includes a progression system with unlockable skins, trails, SFX, and music styles. High scores and settings are persistent.
+
+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.
+
+    Smart AI: Challenge yourself against an optional AI for Player 2.
+
+    Deep Customization: Adjust difficulty levels, map sizes, and obstacle density.
+
+    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.
+
+    Persistence: High scores and settings are automatically saved via JSON.
+
+🛠️ Installation & Setup
+Requirements
+
+    Python: 3.10+ 
+
+    Pygame: 2.6.1 or newer 
+
+Quick Start
+
+    Install dependencies:
+    Bash
+
+    pip install pygame
+
+    Launch the game:
+    Bash
+
+    python snake.py
+
+🎮 Controls
+Action	Player 1	Player 2 (Human)
+Movement	
+
+W, A, S, D
+	
+
+Arrow Keys
+Menu Nav	
+
+Arrows / W, S + Enter
+	—
+Settings	
+
+Mouse Click Support
+	—
+
+    [!TIP]
+    Make sure your audio is enabled to enjoy the full experience with custom SFX and music styles! 
+
+📁 Project Structure
+
+    snake.py: The core game engine and logic.
+
+    snake_settings.json: Stores your personalized configuration.
+
+    snake_high_score.txt: Your legacy of record-breaking runs.