Skip to content

TopMyster/pokemon-python

Repository files navigation

Pokemon Battle Sim Python

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

pbsp.mov

Overview

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

  • A Random Team of Pokémon
  • Turn-based Attack System
  • Randomized Battle Music

Requirements

  • Python 3.13+
  • pypokedex
  • pygame
  • rich

Installation

  1. Clone the repo:
    git clone https://github.com/your-user/pokemon-python.git
    
    cd pokemon-python
  2. Install required packages:
    pip install pypokedex pygame rich

Running the game

From the project folder:

python3 pokemon.py

Then enter 1 at the title screen to start.

TODO

  • Add a Pokémon switching system
  • Improve fainting and battle logic
  • Add more status effects that increase crit damage
  • Implement Pokémon type weaknesses

Disclaimer

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