# TROX – Druckpaket & Generator-Skripte

Alles für Prototyp und Serie bei The Game Crafter (TGC) bzw. ähnlichen Portalen.

## Suit-Codes (NEU, englische Logik)
| Suit | Code | Rolle | Symbol |
|---|---|---|---|
| Red    | **R** | Permanenter TRUMPF | Crown |
| Yellow | **Y** | Standard | Sun |
| Green  | **G** | Standard | Leaf |
| Black  | **B** | Standard | Gear |

Kartencodes auf den Karten z.B. `TK-Y4` (Yellow 4), `TK-G7` (Green 7), `TK-R17`, `TK-B12` (Black 12).

## Was ist drin

| Datei / Ordner | Inhalt |
|---|---|
| `trox_card.js` | **Gemeinsames Modul** – die EINE Kartenzeichnung. Wird von cards + box genutzt |
| `generate_cards.js` | 80 Kartenvorderseiten (TGC + Original) |
| `generate_back.js` | gemeinsame Rückseite (TGC + Original) |
| `generate_box.js` | Tuckbox: Front mit ECHTEN TROX-Karten (aus trox_card.js) + Box-Netz |
| `generate_scorepad.js` | Scorepad als **PDF** – Format/Ausrichtung/Layout/Spielerzahl frei wählbar |
| `make_rules.js` | **Node.js**-Skript der PDF-Anleitung (pdfkit) |
| `svg_to_png.js` | SVG -> PNG Konverter für den TGC-Upload |
| `TROX_Rules_Extended_EN.pdf` | Erweiterte Anleitung mit 3-Spieler-Beispielen |
| `karten_export_tgc/` | 80 Karten + Rückseite, **825x1125 px** (TGC-konform, mit Bleed) |
| `karten_export_original/` | dieselben in **694x1069 px** (Originalmaß) |
| `box_export/` | `trox_box_front.svg` + `trox_box_wrap.svg` |
| `scorepad_export/` | mehrere **PDF**-Varianten (Letter/A4, portrait/landscape, versch. Layouts) |

## Architektur (wichtig)
`trox_card.js` ist die **einzige Quelle** des Kartendesigns:
- `buildCardSVG(colorName, num, opts)` -> komplette Karten-SVG (von generate_cards.js)
- `miniCardGroup(colorName, num, cx, cy, breite, rotation)` -> dieselbe Karte als skalierte Gruppe (von generate_box.js für den Fächer)

Dadurch sind die Karten auf der Box **garantiert identisch** mit den echten Spielkarten – nur skaliert und gefächert. Wer das Design ändert (Farben, Symbole, Schrift), ändert NUR `trox_card.js`, und Karten + Box bleiben synchron.

## Skripte ausführen
```bash
npm install pdfkit          # einmalig, für make_rules.js
node generate_cards.js      # both (TGC + Original)   – oder: tgc | original
node generate_back.js       # both                    – oder: tgc | original
node generate_box.js        # both (front + wrap)     – oder: front | wrap [scale]
node generate_scorepad.js   # PDF, both 2x3 6 Spieler  – [fmt] [orientation] [cols] [rows] [players] [margin]
node make_rules.js          # erzeugt die PDF-Anleitung
```

## Druck-Workflow für The Game Crafter
1. **Produkt:** Karten = *Poker Card* (825x1125). Box für 80 Karten = *Poker Tuck Box (90 cards)*.
2. **SVG -> PNG** (TGC nimmt KEIN SVG):
   ```bash
   npm install sharp
   node svg_to_png.js karten_export_tgc
   node svg_to_png.js box_export
   ```
3. **Hochladen:** PNGs der 80 Karten + Rückseite in den Deck-Uploader.
4. **Box:** offizielles Stanz-Template der "Poker Tuck Box (90 cards)" von TGC laden und in `generate_box.js` die Konstanten `PANEL_W`, `PANEL_H`, `SPINE`, `FLAP` daran angleichen. Faltlinien (gestrichelt) VOR dem Upload entfernen.

### TGC-Specs (bestätigt)
- **300 DPI**, **nur RGB** (CMYK wird abgelehnt).
- **Bleed** 1/8" (≈37 px), **Safe Zone** 1/4" (75 px) vom Rand.

## Anpassen
- **Kartendesign (Farben/Symbole/Schrift):** nur `trox_card.js`.
- **Welche Karten im Box-Fächer:** `cardFan()` in `generate_box.js` (die vier `miniCardGroup(...)`-Aufrufe).
- **Größe der Box-Karten:** `CARD_SCALE` oben in `generate_box.js` (Standard 0.30) ODER per CLI: `node generate_box.js front 0.26`. Eine Auto-Fit-Sicherung verkleinert den Fächer automatisch, falls er aus dem goldenen Rahmen ragen würde. Weitere Fächer-Regler: `FAN_SPREAD`, `FAN_ARC`, `FAN_TILT`, `FAN_CY`.
- **Scorepad-Layout:** voll parametrisierbar per CLI `node generate_scorepad.js [format] [cols] [rows] [players] [margin_in]`. Weniger Cards/Seite = größere, besser lesbare Cards (Schrift skaliert mit). Beispiel gegen zu kleinen Druck: `node generate_scorepad.js letter 1 2 6 0.5` (2 große Cards, 0.5" Rand). Defaults stehen im CONFIG-Block oben im Skript.
- **Anleitung:** `make_rules.js`, klar in Abschnitte gegliedert.

## Offene Designfrage (für dich)
Im Beispiel B summieren sich die Gebote auf genau die Stichzahl – dann können theoretisch alle treffen.
Viele Stichspiele verbieten das ("Screw-the-Dealer"). In der Anleitung ist das als
**optionale Variante "Exact Tension" (Abschnitt 8)** eingebaut. Entscheide, ob das deine Standardregel wird.