Pokemon Battle Sim Python

A simple terminal-based Pokémon battle simulator built with Python.

https://github.com/user-attachments/assets/9cf1306f-e42e-413a-ada2-b77509518ead

Overview

This application lets you battle a randomly selected Pokémon opponent in your own terminal. It includes:

• Real Pokémon Moves and Stats
• Randomized Teams of Pokémon
• Turn-based Attack System
• Randomized Battle Music
• Works Offline

Requirements

• Python 3.13+
• pypokedex
• pygame
• rich

Installation

Install from PyPI

pip install pokemon-battle-sim

Then run the game:

pokemon-battle-sim

Install from source

1. Clone the repo:

   git clone https://github.com/your-user/pokemon-python.git
   cd pokemon-python
   

2. Install in development mode:

   pip install -e .
   

3. Run the game:

   pokemon-battle-sim
   

Running the game

If installed via pip:

pokemon-battle-sim

Or from the source directory:

python3 -m pokemon

Then enter 1 at the title screen to start.

Create a macOS app bundle

Build the macOS .app bundle and DMG from the project root:

chmod +x build_dmg.sh
./build_dmg.sh

The script creates:

• dist/PokemonBattleSim.app
• dist/PokemonBattleSim.dmg

TODO

• Add a Pokémon switching system
• Add more status effects

Disclaimer

All music and sound effects are owned by Pokémon.