CR 27: Poker wird echtes Texas Hold'em

Die CR-17-Variante — eine Setzrunde, je fuenf Karten, kein Aufdecken —
fuehlte sich nicht wie Poker an. Ersetzt durch Heads-up Hold'em: zwei
verdeckte Hole Cards je Seite, die fuenf Gemeinschaftskarten decken sich als
eigene Reihe zwischen den Haenden in drei Schritten auf (Flop, Turn, River),
vier Setzrunden mit Checken, Mitgehen, Erhoehen und Aussteigen. Kleiner und
grosser Blind wechseln pro Hand; der Small Blind handelt Pre-Flop zuerst und
schuldet dort die Blind-Differenz. Fixed Limit mit maximal zwei Erhoehungen
pro Strasse, damit der Pott lesbar bleibt.

CardDeck.evaluate_best_of bewertet die beste 5-aus-N-Kombination ueber einen
allgemeinen Kombinationszaehler — am River 21 Kombinationen; die
Gegner-Einschaetzung ruft am Flop und Turn auch mit fuenf oder sechs Karten
an, der naive Lass-zwei-weg-Ansatz waere am Turn falsch gewesen.

Der Gegner spielt eine Hand konsistent: ob er blufft, wuerfelt er einmal pro
Hand, nicht pro Entscheidung; seine Einschaetzung waechst mit jeder
aufgedeckten Strasse aus der echten Teilbewertung, skill mischt Wahrheit und
Rauschen. Pre-Flop zaehlt eine Hole-Card-Heuristik.

Spieltisch-Anbindung (Einsatz, Sitzordnung, Ridocs Dealer-Regel),
card_view-Platzhalter und das Messerspiel bleiben unveraendert.

Verifiziert mit dev_cr27_probe (16/16, darunter eine komplett
durchgespielte Partie mit Aufdecken bis zum River und Dealer-Wechsel ueber
alle Haende) und einem Boot-Check ueber sieben Szenen; Sonde vor dem Commit
geloescht.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-21 20:33:48 +02:00
parent c929ab8484
commit 1b34931d6e
7 changed files with 350 additions and 161 deletions

View file

@ -41,44 +41,6 @@
(Treiber/Vulkan-Stall beim ersten Betreten einer Szene, Fokus-Verlust im
Editor-Vollbild) lassen sich erst mit einem echten Log belegen.
## 27. Poker wird echtes Texas Hold'em (ersetzt CR-17-Umsetzung)
> Autor-Entscheidung (2026-07-21): Die CR-17-Umsetzung (`poker_game.gd`) ist
> eine einzige Setzrunde mit je 5 verdeckten Karten ohne Kartentausch — fühlt
> sich nicht wie Poker an. **Ersetzt durch echtes Texas Hold'em.** Meine
> ursprüngliche CR 17 hat die Variante nie festgelegt — das war eine
> Spezifikations-Lücke, keine falsche Umsetzung.
- **Regeln:**
- Jeder Spieler bekommt **2 verdeckte Handkarten** (Hole Cards).
- **Gemeinschaftskarten** werden in drei Schritten aufgedeckt: **Flop** (3
Karten auf einmal), **Turn** (1 Karte), **River** (1 Karte).
- **Vier Setzrunden**, je eine nach: Hole Cards (Pre-Flop), Flop, Turn,
River. Optionen: Checken (wenn niemand gesetzt hat), Mitgehen, Erhöhen,
Aussteigen.
- **Blinds statt reinem Ante:** Kleiner/großer Blind wechseln pro Runde
zwischen Spieler und Gegner (Heads-up-Poker, 1 gegen 1).
- **Showdown:** beste 5-Karten-Hand aus den 7 verfügbaren (2 eigene + 5
Gemeinschaftskarten).
- **Technische Delta-Notiz (aus Code-Lektüre):** `CardDeck.evaluate()` nimmt
aktuell **genau 5 Karten** an (Flush-/Straight-Prüfung geht von exakt 5
Werten aus). Für Hold'em wird eine **Best-of-7-Bewertung** gebraucht (die
beste 5-Karten-Kombination aus 7 testen, 21 Kombinationen) — das ist eine
echte Erweiterung, kein Aufruf-Detail.
- **Gegner-KI:** `_decide()` muss über **mehrere Straßen** hinweg konsistent
bluffen/einschätzen (aktuell nur einmalig), inkl. steigendem Pot über die
Runden. `skill`/`bluff_rate` pro Gegner bleiben als Konzept erhalten.
- **UI:** Gemeinschaftskarten-Reihe zwischen den beiden Händen, die sich nach
Flop/Turn/River sukzessive füllt — genau das „Kartenaufdecken", das der
Autor vermisst hat. Eigene Hole Cards bleiben offen, Gegner-Hole-Cards
verdeckt bis zum Showdown.
- **Betrifft:** `poker_game.gd` (weitgehende Neufassung), `card_deck.gd`
(Best-of-7-Bewertung), `card_view.gd` (Gemeinschaftskarten-Layout),
`data/minigames/table_games.json` (Runden-Konfiguration anpassen).
Platzhalter-Karten-Prinzip aus CR 17 bleibt (Bau wartet nicht auf PNGs).
- **Akzeptanz:** Eine Partie läuft über Pre-Flop/Flop/Turn/River mit je einer
Setzrunde; Gemeinschaftskarten decken sich sichtbar auf; Showdown wählt
korrekt die beste 5-aus-7-Kombination beider Seiten; Blinds wechseln pro
Runde. Messerspiel bleibt unverändert (nutzt kein Kartenblatt).
## 24. Primitiven-Austausch in den echten Szenen (Folge-Schritt aus CR 23)
> Aufgemacht am 2026-07-21, nachdem CR 23 die Pipeline verifiziert hat. Die
> Assets liegen sortiert und importiert unter `assets/models/`, die

View file

@ -3,6 +3,51 @@
> Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und
> Anmerkung, was geändert wurde.
## 2026-07-21 — CR 27: Poker wird echtes Texas Hold'em
**Request:** CHANGEREQUESTS §27 — die CR-17-Umsetzung (eine Setzrunde,
je fünf Karten, kein Aufdecken) fühlte sich nicht wie Poker an.
Autoren-Entscheidung: echtes Heads-up Texas Hold'em, ersetzt die
CR-17-Spielmechanik komplett.
**Regeln wie gefordert:** 2 verdeckte Hole Cards je Seite; die fünf
Gemeinschaftskarten decken sich in drei Schritten auf (Flop 3, Turn 1,
River 1) und liegen sichtbar als eigene Reihe zwischen den Händen;
**vier Setzrunden** (Pre-Flop/Flop/Turn/River) mit Checken (wenn nichts
im Raum steht), Mitgehen, Erhöhen, Aussteigen; **kleiner und großer
Blind wechseln pro Hand** zwischen Spieler und Gegner, der Small Blind
handelt Pre-Flop zuerst und schuldet dort die Blind-Differenz
(Heads-up-Regel); der **Showdown wählt die beste 5-Karten-Hand aus 7**.
Fixed Limit mit maximal zwei Erhöhungen pro Straße, damit der Pott
lesbar bleibt.
**Technik:** `CardDeck.evaluate_best_of()` bewertet die beste
5-aus-N-Kombination über einen allgemeinen Kombinationszähler — am
River 21 Kombinationen, und die Gegner-Einschätzung ruft am Flop/Turn
auch mit 5 oder 6 Karten an (der naive „lass zwei weg"-Ansatz wäre am
Turn falsch gewesen). `poker_game.gd` weitgehend neu; die
Spieltisch-Anbindung (Einsatz multipliziert den Saldo, Sitzordnung,
Ridocs Dealer-Regel) blieb unverändert, ebenso das Messerspiel.
**Gegner-KI über die Straßen:** Ob der Gegner blufft, würfelt er
**einmal pro Hand** (bluff_rate), nicht pro Entscheidung; seine
Einschätzung wächst mit jeder aufgedeckten Straße aus der echten
Teilbewertung seiner Karten, `skill` mischt Wahrheit und Rauschen.
Pre-Flop zählt eine Hole-Card-Heuristik (Paar/hohe Karte).
**Platzhalter-Prinzip aus CR 17 bleibt:** `card_view.gd` unverändert —
liegen die PNGs unter `assets/ui/cards/`, wird es hübscher, nicht anders.
**Verifikation:** Sonde `dev_cr27_probe` 16/16 — Best-of-7 findet den
Flush hinter dem Ass-Paar, Best-of-6 das Full House am Turn, 21
Kombinationen aus 7 Karten; Blinds statt Ante in der Konfiguration;
eine komplett durchgespielte Partie (2 offene eigene, 2 verdeckte
Gegner-Karten, 5 verdeckte Gemeinschaftskarten, Blinds im Pott,
Aufdecken bis zum River, Dealer-Wechsel über alle Hände, Saldo am
Ende); nur Aussteigen verliert höchstens die Blinds; Messerspiel
kartenfrei und Spieltisch-Anbindung unverändert. Boot-Check über sieben
Szenen fehlerfrei. Sonde vor dem Commit gelöscht.
## 2026-07-21 — CR 26: Stimmen-Schreibpass fertiggestellt (die restlichen 31 Dateien)
**Request:** CHANGEREQUESTS §26 — CR 19+22 hatte nur 11 Dateien wirklich

View file

@ -136,6 +136,7 @@ Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis.
| 22 | Journal/Lexicon-Texte | Politur | erledigt (2026-07-21) |
| 25 | Absturz bei Türwechseln (Bug) | Politur | **in Beobachtung (2026-07-21)** — nicht reproduzierbar (175+ Wechsel sauber); Härtung + Log-Forensik drin, wartet auf nächsten Vorfall mit Log |
| 26 | Schreibpass-Rest (31 Dateien) | Politur | **erledigt (2026-07-21)** — alle 31 geprüft, 15 umgeschrieben nach STIMMEN.md; Fingerabdruck strukturgleich, 17 erledigte Dateien unangetastet |
| 27 | Poker → Texas Hold'em | Politur | **erledigt (2026-07-21)** — Hole Cards, Flop/Turn/River, vier Setzrunden, wechselnde Blinds, Best-of-7-Showdown |
| 23 | Asset-Import-Grundausstattung (Quaternius) | Politur | **erledigt (2026-07-21)** — 296 Modelle sortiert unter `assets/models/`, Rig-Kompatibilität in `scenes/test/asset_pipeline_test.tscn` verifiziert |
| 24 | Primitiven-Austausch in den echten Szenen | Politur | offen — Folge-Schritt aus CR 23, Pipeline steht |
| 25 | Türwechsel-Absturz (Bug) | Politur | offen — Verdacht in `zone_trigger.gd`, Repro + Stack-Trace nötig |