deckhearth/GAME_FEATURES.md

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)