Skip to content

README.md

Latest commit

 

History

History
135 lines (91 loc) · 2.96 KB

README.md

File metadata and controls

135 lines (91 loc) · 2.96 KB

🎮 Python Turn Based Game

A simple turn-based RPG game built in Python that runs in the terminal.

This project was created as a learning project to practice Python architecture, modular code organization, and game logic.

Players can explore the world, encounter enemies, and fight using abilities in a turn-based combat system.

🕹️ Features

  • 🧭 Exploration system
  • 👾 Random monster encounters
  • ⚔️ Turn-based combat
  • 🎒 Inventory system
  • 🧙 Player abilities
  • 🎲 Randomized events
  • 🧩 Modular project structure

🖥️ Gameplay

The game runs entirely in the terminal using a menu-based system.

Example flow:

  1. Player starts the game
  2. Chooses an action
  3. Explores the world
  4. Encounters monsters or finds loot
  5. Battles enemies in a turn-based combat system

Example combat screen:

You were intercepted by a Skeleton!

MONSTER: Skeleton
HP: 20

1. Attack
2. Use Ability
3. Run

🏗️ Project Structure

src/
│
├── actions/
│   ├── player_actions.py
│   └── combat_actions.py
│
├── methods/
│   ├── texteffect.py
│   └── player_create.py
│
└── main.py

⚙️ Installation

Clone the repository:

git clone https://github.com/jotaaave/python-turn-based-game.git

Enter the project folder:

cd python-turn-based-game

Run the game:

python src/main.py

📦 Requirements

  • Python 3.8+
  • No external libraries required

🚀 Future Features

Planned improvements:

  • NPC interaction system
  • Loot and reward system
  • Equipment and items
  • More monsters and abilities
  • Save / Load system
  • Procedural areas

🧠 Learning Goals

This project was built to practice:

  • Python programming
  • Object-oriented design
  • Game loops
  • State management
  • Modular project architecture

🤝 Contributing

Contributions are welcome.

If you'd like to improve the project:

  1. Fork the repository
  2. Create a new branch
  3. Commit your changes
  4. Open a Pull Request

📜 License

This project is open source and available under the MIT License.