Metadata-Version: 2.4
Name: pyvgc
Version: 0.0.2
Summary: A Pokémon Champions data science package.
Author: Voozde
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# PYVGC

PYVGC is a Python package for basic Pokémon Champions-based data science.
It is currently meant for Python 3.9 and newer, without runtime dependencies.

Regulations scope legal Pokémon, moves,items, and learnsets, while named `BattleLogic` instances preserve historical and future rule sets. 

Both `Cartridge-Champions-Release-2026` and `Simulator-Champions-Release-2026` are available. Regulation snapshots default to Cartridge rules and can be loaded with `platform="Simulator"` for simulator rules.

All current development is meant for early implementation. Until 0.1 this package is on alpha development.

Version 0.0.1 provides:

- Level-50 Pokémon loading from the bundled roster;
- Stat training, natures, and stat stages;
- Pokémon battle type and held-item accessors (no in-battle functionality);
- normal and critical damage rolls;
- move, learnset, and Pokémon-for-move lookups;
- Bundled battle-item reference data with effect descriptions crawled from
  [Serebii's ItemDex](https://www.serebii.net/itemdex/).

Item effects and regulation item membership are descriptive data only; item
mechanics are not implemented in damage calculations. Teams, weather, terrain,
and KO-target searches are not part of this MVP. Regulation snapshots and the
single-ability query are available as data utilities; they do not affect
damage calculations.

The package is maintained by Voozde.

AI DISCLAIMER

Current development is assisted by the VSCode Copilot Plugin, which settled on Gpt-5.6-Luna
