95 lines
No EOL
3.2 KiB
Markdown
95 lines
No EOL
3.2 KiB
Markdown
# 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) |