Skip to content

jotaaave/python-turn-based-game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

9 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽฎ 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.

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages