🧩 Pygame Procedural Maze Generator & Game

Khwarazmi University (Karaj Campus)
Advanced Programming (AP) Project
Date: June 1, 2024

Instructor: Eng. Zahra Alizadeh
Authors:

• Rouhollah Hosseini
• Shayan Rezapour

---

📝 About The Game

A dynamic, level-based 2D Maze game built with Python and Pygame. The game features dynamically generated mazes using a randomized Depth-First Search (DFS) algorithm that gets progressively challenging as you advance through levels. You can play as much as you like and enjoy solving infinite procedural mazes! :)

این بازی قابلیت ساخت ماز تصادفی را دارد و در هر مرحله سخت‌تر می‌شود و می‌توانید هر چقدر که دوست دارید بازی کنید و لذت ببرید! :)

---

✨ Features

• Procedural Generation: Every level features a unique, randomly generated maze structure.
• Progressive Difficulty: As the level increases, the cell sizes shrink and the maze layout grows larger and more intricate.
• Smooth Game Loop: Runs at 60 FPS with responsive movement controls.
• Audio & Visual Flexibility: Gracefully falls back if optional sound tracks or icons are missing without crashing the game.
• 10 Challenge Levels: Reach the final exit at Level 10 to clear the game!

---

🎮 How to Play

Objectives

• Blue Square: Starting Point $(1, 1)$
• Orange Square: Exit / Goal Target
• Green Square: Player character

Navigate your player from the blue start point to the orange destination to advance to the next level.

Controls

Use the Arrow Keys on your keyboard to navigate:

• Up Arrow: Move Up
• Down Arrow: Move Down
• Left Arrow: Move Left
• Right Arrow: Move Right

---

🚀 Installation & Usage / نحوه استفاده

Prerequisites

Make sure you have Python 3 installed on your system.

Steps

1. Download or extract the project files.
2. Open your terminal / command prompt in the project directory and run:

   pip install -r requirements.txt
   python3 app.py