🗡️ RogueLikeDungeonGame

RogueLikeDungeonGame is a top-down roguelike dungeon crawler built with Python. The game focuses on procedurally generated dungeons, player exploration and combat, enemy AI behavior, loot collection, and classic permadeath mechanics to deliver a challenging and highly replayable experience.

---

🎮 Project Overview

This project implements a complete roguelike gameplay loop where each run is unique. Dungeons are generated randomly, enemies behave dynamically, and the player must survive using strategy and skill. The codebase is modular and structured to allow easy extension of gameplay mechanics.

The project covers:

• Procedural dungeon generation
• Player movement and combat
• Enemy AI logic
• Loot and exploration systems
• Logging and demo modules

---

✨ Features

• 🌀 Procedural Dungeon Generation
  Randomly generated dungeon layouts ensure a different experience every run.

• ⚔️ Combat System
  Players can engage enemies using core combat mechanics defined in the game logic.

• 🤖 Enemy AI
  Enemies exhibit basic AI behaviors such as movement, chasing, and attacking the player.

• 🎒 Exploration & Loot
  Players explore rooms and corridors while collecting items and surviving encounters.

• 💀 Permadeath
  On death, progress is reset, reinforcing classic roguelike gameplay principles.

• 📊 Logging & Demo Support
  Logs and demo modules are included for debugging, testing, and showcasing gameplay behavior.

---

⚙️ Technologies Used

• Python – Core programming language
• Game Modules – Modular architecture for player, enemies, dungeon logic, and utilities
• Logging – Tracking gameplay events and debugging

---

🚀 How to Run Locally

1. Clone the repository

   git clone https://github.com/CherrySeasons/RogueLikeDungeonGame.git
   cd RogueLikeDungeonGame

2. (Optional) Create and activate a virtual environment

python -m venv venv
source venv/bin/activate      # Linux / macOS
venv\Scripts\activate         # Windows

3. Install dependencies

pip install -r requirements.txt

4. Run the game

python main.py

(If the entry file differs, run the appropriate game launcher script.)

---

📂 Project Structure

├── demos/                 # Demo scripts and example runs
├── game/                  # Core game logic and modules
├── logs/                  # Gameplay and debug logs
├── requirements.txt       # Project dependencies
├── project_structure.txt  # Project structure reference
├── LICENSE                # License file
├── README.md              # Project documentation
└── main.py                # Game entry point

---

🎯 Gameplay Controls

• Move the player using keyboard controls (as defined in the game logic)

• Explore dungeon rooms and corridorsic

• Fight enemies and collect loot

• Try to survive as long as possible

---

🔮 Future Improvements

• Enhanced enemy AI and behaviors

• Additional dungeon themes and levels

• Sound effects and background music

• Save and load game functionality

• Improved visuals and animations

---

📜 License

This project is licensed under the MIT License.

---

👤 Author

Teja Sai Eswar Reddy
Student, IIT Kharagpur – ECE Department (3rd Year)