Files
mtg-builder/docs/templates/README.template.md
2026-02-20 00:03:02 +01:00

78 lines
1.8 KiB
Markdown

# MTG EDH Deck Manager
Command-line toolkit for managing Magic: The Gathering Commander (EDH) decks using the Scryfall API.
## Installation
```bash
git clone <repo-url>
cd Decks
```
No dependencies required - pure Python 3 standard library.
## Usage
### Hydrate a Collection
Fetch card data from Scryfall for a decklist:
```bash
python hydrate.py hydrate collection/decklist.txt -o collection_hydrated/ -c card_cache.json
```
### Create a New Deck
```bash
python hydrate.py new my_deck
```
### Analyze Decks
Find upgrade options from your collection:
```bash
python scripts/analyze_decks.py --collection collection_hydrated/deck.json --deck-dir decks/
```
### Find Synergies
Search for cards by keywords, colors, and type:
```bash
# Find landfall cards in Simic colors
python scripts/find_synergies.py --collection collection_hydrated/deck.json --colors U G --keywords landfall
# Find Bird creatures in Bant colors
python scripts/find_synergies.py --collection collection_hydrated/deck.json --colors U G W --creature-type Bird
# Find instants with CMC 2 or less
python scripts/find_synergies.py --collection collection_hydrated/deck.json --type instant --cmc-max 2
```
### Generate Reports
```bash
python scripts/deck_report.py --collection collection_hydrated/deck.json --decks-dir decks/ --output report.md
```
## Decks
{{DECK_TABLE}}
## Workflow
1. **Import** - Place text decklists in `collection/`
2. **Hydrate** - Run `hydrate.py` to fetch Scryfall data → `collection_hydrated/`
3. **Define** - Create deck JSON files in `decks/`
4. **Analyze** - Run `analyze_decks.py` to find upgrade options
5. **Report** - Use `deck_report.py` for markdown summaries
## Collection Stats
{{COLLECTION_STATS}}
---
*This file is auto-generated. Edit `docs/templates/README.template.md` instead.*