🏃‍♂️ CodeRunner

A fast-paced, procedurally generated survival game built with Python + Pygame. Dodge enemies, collect power-ups, and survive as long as you can in a neon cyber grid. 👾⚡

---

🎮 Features

• ⚡ Procedural Generation: Each run is completely unique with random enemies, power-ups, and obstacles.
• 🕹️ Survival Gameplay: Dodge, shoot, and outmaneuver endless waves of enemies.
• 💾 Save/Load System: Resume your game anytime.
• 🧩 Multiple Enemy Types: Different behaviors = endless chaos.
• 🎨 Retro Neon Vibes: Pixel-inspired design with glowing cyberpunk colors.
• 🔊 Optional Sound Support: Add your own music/SFX for immersion.

---

🛠️ Installation

Make sure you have Python 3.9+ installed.

1. Clone the repository:

   git clone https://github.com/yourusername/CodeRunner.git
   cd CodeRunner

2. Create a virtual environment (recommended):

   python -m venv venv
   source venv/bin/activate   # On Windows: venv\Scripts\activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

---

▶️ How to Play

Run the game with:

python main.py

---

Controls

• ⬅️⬆️➡️⬇️ Arrow Keys – Move your runner.

• Space – Shoot projectiles.

• Esc – Pause/Quit.

---

🧠 Gameplay Overview

• Survive waves of enemies attacking from all directions.

• Collect power-ups to gain speed, health, or firepower.

• Every second alive increases difficulty.

• Random obstacles mean no two runs are the same.

  Think Snake + Rogue + Space Invaders… but on neon steroids. ⚡👾

---

🤝 Contributing

Pull requests are welcome! Here’s how:

1. Fork the repo

2. Create a feature branch

3. Commit your changes

4. Open a pull request 🚀

---

📜 License

MIT License – free to use, remix, and share.