Dinger: Kartenspiel in Godot 4.7

Elemente, Kombos, Fallen, KI mit Vorausschau, Kampagne, Hotseat und Netzwerk,
Werkstatt, Erfolge, Tagesaufgaben, Tests und Exporte.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPgKvy5W9WRNFHjkm5QsHx

README.md

@@ -0,0 +1,62 @@
+# Dinger
+
+Kartenspiel in 2D (Godot 4.7): du und 1 bis 5 KI-Magier, jeder gegen jeden, alle mit denselben Regeln.
+
+## Start
+
+Projektordner in Godot öffnen und auf „Play“ drücken, oder im Terminal:
+
+```
+godot --path .
+```
+
+Der Spielstand liegt unter `user://spielstand.json`
+(Linux: `~/.local/share/godot/app_userdata/Dinger/spielstand.json`).
+
+## Spielsysteme
+
+- 100 Karten in `data/karten.json`: 4 Elemente, 10 Zweier-Kombos (auch gleiche Elemente), 4 mythische Dreifach-Kombos, 4 Fallen
+- Resonanz: gleiche Elemente auf dem Feld verstärken sich. Feldkombos: verschiedene Elemente lösen beim Ausspielen Effekte aus
+- Fallen liegen verdeckt und lösen im gegnerischen Zug aus (die KI kennt fremde Fallen nicht)
+- Jeder gegen jeden mit ausgeloster Zugreihenfolge, 1 bis 5 KI-Gegner (KI mit Vorausschau), Kampagne mit 10 Magiern, Erfolge, Tagesaufgabe
+- Lokal zu mehreren: bis zu 4 Menschen am selben Rechner plus KI
+- Booster, fünf Deck-Slots, Werkstatt (Zerlegen und Herstellen aus Staub), Einstellungen (Ton, KI-Tempo, Animationen)
+- Spielstand versioniert mit Sicherungskopie (`spielstand.json.bak`)
+- Anleitung (geführte erste Partie), Mulligan im ersten Zug, Tastatur (Leertaste, 1 bis 9, Esc, Enter)
+- Kampagnen-Bosse mit Merkmalen, Kartenstatistik, zwölf Tagesaufgaben, Pity-Zähler für mythische Karten
+- Netzwerkspiel im lokalen Netz (Host führt das Spiel, Mitspieler sehen nur ihre Hand)
+- Deck-Namen, Auto-Ausfüllen, Hintergrundmusik und Oberfläche wahlweise auf Englisch
+
+## Tests
+
+`tests/run_headless.sh` führt Import und Headless-Prüfungen aus (auch in `.github/workflows/tests.yml`).
+
+```
+godot --headless --path . --import              # einmalig: Ressourcen importieren
+godot --headless --path . -s tests/test_runner.gd   # Regeln, KI, Booster, Spielstand
+godot --headless --path . -s tests/simulate.gd      # Balance: KI spielt gegen KI
+godot --headless --path . -s tests/matchup.gd       # Startvorteil und Mono gegen Paar
+godot --headless --path . -s tests/dump_cards.gd    # Kartenpool aus Code nach JSON schreiben (nur bei Bedarf)
+DINGER_SHOTS=/tmp/shots godot --path . tests/ui_test.tscn   # Oberfläche mit Fenster und Screenshots
+```
+
+## Export
+
+Export-Vorlagen für Godot 4.7 installieren (Editor: Editor → Export-Vorlagen verwalten), dann:
+
+```
+godot --headless --path . --export-release Linux build/dinger-linux.x86_64
+godot --headless --path . --export-release Windows build/dinger-windows.exe
+```
+
+## Aufbau
+
+- `scripts/cards.gd` – Elemente, Kombos, Kartenklassen; Pool aus `data/karten.json`
+- `scripts/game.gd` – Spielregeln, Züge, Kampf, Fallen, Feldkombos, Resonanz, Deckregeln, Gegner, Hotseat
+- `scripts/ai.gd` – KI mit Vorausschau (plus gierige Vergleichs-KI)
+- `scripts/profile.gd` – Spielstand (versioniert), Booster, Erfolge, Tagesaufgabe, Einstellungen
+- `scripts/campaign.gd` – Kampagnenstufen
+- `scripts/ui/` – Oberfläche: Menü, Gegnerauswahl, Kampagne, Hotseat, Lobby, Booster, Deckbau, Werkstatt, Kampf (Bildschirm, Layout, Effekte), Erfolge, Einstellungen, Regeln, Ton
+- `scenes/main.tscn` – Startszene
+- `scripts/net.gd` – Netzwerkspiel (ENet)
+- `translations/ui.csv` – englische Oberflächentexte