# Game-Specific Features Guide

## Supported Trading Card Games

### Magic: The Gathering (MTG)
**Game Code**: `MTG`

**Key Features**:
- Mana costs with colored symbols `{W}{U}{B}{R}{G}{C}`
- Converted Mana Cost (CMC)
- Card types: Creature, Instant, Sorcery, Artifact, Enchantment, Planeswalker, Land
- Power/Toughness for creatures
- Loyalty for planeswalkers
- Colors: White, Blue, Black, Red, Green, Colorless
- Rarities: Common, Uncommon, Rare, Mythic Rare

**Sample Cards Added**:
- Lightning Bolt (Red Instant)
- Black Lotus (Artifact)

### Pokémon 
**Game Code**: `POKEMON`

**Key Features**:
- Energy costs (Fighting, Fire, Water, Lightning, Psychic, Grass, Darkness, Metal, Fairy, Colorless)
- HP for Pokémon
- Attack damage
- Weakness/Resistance
- Card types: Pokémon, Trainer, Energy
- Pokémon stages: Basic, Stage 1, Stage 2, EX, GX, V, VMAX
- Rarities: Common, Uncommon, Rare, Ultra Rare, Secret Rare

**Sample Cards Added**:
- Pikachu (Basic Lightning Pokémon)

### Disney Lorcana
**Game Code**: `LORCANA`

**Key Features**:
- Ink costs (single number)
- Characters have Strength and Willpower
- Card types: Character, Action, Item, Location
- Character classifications: Storyborn, Dreamborn, Floodborn
- Ink colors: Amber, Amethyst, Emerald, Ruby, Sapphire, Steel
- Abilities: Evasive, Ward, Bodyguard, Challenger, Rush, Shift, Support
- Songs can be sung by characters
- Rarities: Common, Uncommon, Rare, Super Rare, Legendary, Enchanted

**Sample Cards Added**:
- Mickey Mouse - Brave Little Tailor (Legendary Amber Character)
- Elsa - Snow Queen (Super Rare Sapphire Character)  
- Be Prepared (Rare Emerald Action/Song)
- Mickey Mouse - Steamboat Pilot (Common Amber Character)

## Database Field Mapping

### Universal Fields
- `name`: Card name
- `game`: Game code (MTG/POKEMON/LORCANA)
- `set_name`: Set/expansion name
- `set_code`: Set abbreviation
- `card_number`: Collector number
- `rarity`: Rarity level
- `current_price`: Market price
- `image_url`: Card image URL

### Game-Specific Field Usage

| Field | MTG | Pokemon | Lorcana |
|-------|-----|---------|---------|
| `mana_cost` | Mana symbols | Energy requirements | Ink cost |
| `cmc` | Converted mana cost | Total energy cost | Ink cost |
| `card_type` | Full type line | Card type + stage | Character classification |
| `colors` | Color identity | Energy types | Ink colors |
| `power` | Creature power | Attack damage | Character strength |
| `toughness` | Creature toughness | HP | Character willpower |
| `loyalty` | Planeswalker loyalty | - | - |
| `oracle_text` | Rules text | Effect text | Ability text |

## Future Implementation Ideas

### OCR Recognition Patterns
- **MTG**: Recognize mana symbols, card frames, set symbols
- **Pokemon**: Identify energy symbols, HP values, stage indicators
- **Lorcana**: Detect ink costs, character stats, Disney artwork style

### Deck Building Rules
- **MTG**: 60-card minimum, 4-of limit, format restrictions
- **Pokemon**: 60-card decks, prize cards, energy requirements
- **Lorcana**: 60-card decks, ink system, character limits

### Pricing Sources
- **MTG**: TCGPlayer, MTG Goldfish, EDHREC
- **Pokemon**: TCGPlayer, PTCGO prices, PokeBeach
- **Lorcana**: TCGPlayer, eBay sold listings (newer game)