mantimon-tcg/backend/data/definitions
Cal Corum e237a0deb6 Add image_url to card definitions from source data
The converter now falls back to using the source image_url from raw
data when image_file is not available (images not downloaded locally).

- Pokemon cards: use source image_url when image_file is null
- Trainer cards: same fallback behavior
- Regenerated all 382 card definitions with image URLs

Images point to pokemon-zone.com assets for now. When we host our
own images, cards with image_file will use our CDN instead.
2026-01-27 15:55:10 -06:00
..
energy/basic Add image_url to card definitions from source data 2026-01-27 15:55:10 -06:00
pokemon Add image_url to card definitions from source data 2026-01-27 15:55:10 -06:00
trainer Add image_url to card definitions from source data 2026-01-27 15:55:10 -06:00
_index.json Add image_url to card definitions from source data 2026-01-27 15:55:10 -06:00
README.md Add CardService and card data conversion pipeline 2026-01-27 14:16:40 -06:00

Card Definitions (Authoritative)

These JSON files are the authoritative source for card data used by the game engine. Edit these files for gameplay changes.

Structure

definitions/
├── _index.json          # Master index with all cards + set metadata
├── pokemon/
│   ├── a1/              # Pokemon from Genetic Apex
│   └── a1a/             # Pokemon from Mythical Island
├── trainer/
│   ├── a1/              # Trainers from Genetic Apex
│   └── a1a/             # Trainers from Mythical Island
└── energy/
    └── basic/           # Universal basic energy cards

Generating Definitions

Definitions are generated from raw scraped data:

cd backend
python scripts/convert_cards.py

After generation, you can manually edit files for corrections or gameplay tweaks.

Schema

Each JSON file conforms to the CardDefinition Pydantic model in app/core/models/card.py.

Key fields:

  • id: Unique identifier (e.g., "a1-001-bulbasaur")
  • name: Display name
  • card_type: "pokemon", "trainer", or "energy"
  • set_id: Which set this card belongs to

See the model documentation for complete field descriptions.