Skip to content

Repository files navigation

🐉 Monster Battle ⚔️

Build Status Latest Release

A fully-featured, turn-based monster battling game built in Python using Pygame-CE. Assemble your team, master the elemental type matchups, and defeat your opponents to achieve victory!

✨ Features

  • Turn-Based Combat: Classic RPG-style battling system.
  • Elemental Matchups: Strategic combat featuring Fire, Water, Plant, and Normal types.
  • Roster Management: Switch dynamically between your active team of monsters during battle.
  • Animations & Audio: Animated attack sprites, screen shakes, and engaging sound effects.
  • Dynamic UI: Intuitive, grid-based menus with dynamic health bars and battle logs.
  • Fullscreen Experience: Scales seamlessly to your native display resolution.

📸 Screenshots

🎮 Controls

Key Action
Arrow Keys (↑ ↓ ← →) Navigate menus / Select monsters and attacks
Spacebar Confirm selection / Action
ESC Go back (in menus) / Quit Game (from main or end screen)

🚀 How to Play (Standalone Executable)

If you have downloaded the .exe version of the game:

  1. Simply double-click MonsterBattle.exe (or main.exe).
  2. The game will launch in fullscreen mode automatically. No installation required!

🛠️ How to Run from Source

If you want to run or modify the game's Python source code, follow these steps:

  1. Clone or Download this repository.
  2. Create a Virtual Environment (Recommended):
    python -m venv venv
    venv\Scripts\activate   # Windows
    # source venv/bin/activate # Mac/Linux
  3. Install Dependencies:
    pip install -r requirements.txt
  4. Run the Game:
    python code/main.py

📦 Building the Executable

To compile the game into a standalone .exe using PyInstaller, run the following command from the root project directory:

pyinstaller --noconsole --onefile --name MonsterBattle --icon=icon.ico --add-data "icon.ico;." --add-data "images;images" --add-data "audio;audio" code\main.py

The compiled game will be generated inside the dist folder.

About

A turn-based monster battling RPG built with Python and Pygame-CE. Assemble your team, master elemental type matchups, and defeat your opponents to achieve victory!

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages