Skip to content

Dechrissen/teamgen

Repository files navigation

TeamGen – Universal Party Generator

A tool for generating a random, progression-viable party of six Pokémon for use in a playthrough. Pokémon availability and game progression are respected in the final output, and customization options are available to curate the output further.

Table of contents

  1. Introduction
  2. Currently supported games
  3. Installation
  4. Usage
  5. Contributing
  6. License

Introduction

TeamGen generates (prescribes) a party for use in a playthrough — either to introduce an element of challenge or simply for team inspiration. The tool is universal in the sense that it maintains compatibility with most generations of Pokémon, but also with romhacks that might contain the following (as long as the relevant game data files are added):

  • New Pokémon
  • New locations
  • Changes to existing game data (location data, evolution methods, etc.)

Currently supported games

Installation

Option 1: Linux / macOS (Recommended)

Prerequisites:

  • Python 3.10+
  • pip
  • (Optional) venv

Steps:

  1. Clone this repository (or download the latest release source code and extract it)
  2. cd teamgen
  3. (Optional) Create a virtual environment first for less headache
    • python -m venv .venv
    • source .venv/bin/activate
  4. Install dependencies (pip install -r requirements.txt)
  5. Run with python main.py

Option 2: Windows – Prebuilt executable

  1. Download teamgen-<version>.zip from the latest release assets
  2. Extract
  3. Run teamgen.exe

Usage

Using the app

  • ENTER – Generate a party with the current settings
  • G – Toggle the generation mode between Progression-viable and Random
    • Progression-viable: Considers game data, locations, progression, config settings
    • Random: Completely random generation
  • S – Open the 'Set game' menu to switch current game setting
  • R – Reload the config file (after making any config changes while the app is running)
  • Q – Quit the app

Changing config settings

Open /config/config_gen1.yaml (for example, for Generation 1 games). Modify values according to your preferences. Save the file and then use the R option in the app to reload.

Note

If you are running the Windows executable, the config files are in /_internal/config.

Contributing

If you'd like to add support for a missing game or romhack, see CONTRIBUTING.md.

License

TeamGen is licensed under the MIT License. See the LICENSE file for full details.

About

Universal Pokémon party generator

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project