Files
pokemon-battle-engine/data

Data Directory (data/)

This directory contains all Pokemon game data files for Generation 1.

Planned Structure

data/
├── pokemon/           # Pokemon species data
│   ├── species.json   # Base stats, types, learn sets
│   └── sprites/       # Pokemon sprite images (optional)
├── moves/             # Move definitions
│   ├── moves.json     # Move data (power, accuracy, PP, etc.)
│   └── effects.json   # Special move effects
├── types/             # Type system data
│   └── effectiveness.json  # Type matchup chart
├── items/             # Items and held items (if implemented)
│   └── items.json     # Item effects and properties
├── mechanics/         # Game mechanics data
│   ├── formulas.json  # Damage calculation formulas
│   └── constants.json # Game constants (crit ratios, etc.)
└── validation/        # Data validation schemas
    ├── pokemon.schema.json
    ├── moves.schema.json
    └── types.schema.json

Data Format

All data files use JSON format for:

  • Human Readability: Easy to edit and review
  • Validation: JSON schema validation support
  • Tooling: Python scripts can easily process JSON
  • Version Control: Clear diffs for changes

Generation 1 Scope

This directory focuses exclusively on Generation 1 data:

  • 151 Pokemon species (Bulbasaur through Mew)
  • Original 165 moves
  • 15 types (no Dark/Steel/Fairy)
  • Original battle mechanics and formulas

Data Sources

Data should be sourced from authoritative references:

  • Bulbapedia for move and Pokemon data
  • Smogon for competitive mechanics
  • Original game ROM analysis for accurate formulas

Validation

Python tools in tools/data/ will validate all data files against schemas to ensure consistency and correctness.