CR 17: Poker mit echten Karten und Figuren am Tisch

Poker lief bisher ueber Menue-Optionen und fuehlte sich nicht wie Poker an.
Jetzt liegt ein echtes Blatt auf dem Tisch.

CardDeck mischt aus data/minigames/cards.json ein volles 52er-Blatt und
bewertet fuenf Karten nach den echten Poker-Raengen — hohe Karte bis Straight
Flush, inklusive kleiner Strasse mit tiefem Ass und Stichentscheid bei
gleicher Kategorie. Bewusst ohne Godot-Knoten, damit die Rechnung direkt
pruefbar ist.

Echte Setzrunden: beide bekommen fuenf Karten, die des Gegners liegen
verdeckt. Der Spieler eroeffnet, der Gegner antwortet mit eigener
Entscheidung — er schaetzt sein Blatt nach seinem skill ein und erhoeht mit
schwachem Blatt nur, wenn er blufft. Danach Showdown mit benanntem Rang.

card_view zeigt die PNG aus assets/ui/cards/, sobald sie da ist, und zeichnet
sonst eine Platzhalter-Karte aus Rechteck, Wert und Farbzeichen. Ein README
im Zielordner dokumentiert die Benennung. Der Bau hat nicht auf die Assets
gewartet, und mit ihnen wird es nur huebscher, nicht anders.

table_seating fuehrt den gewaehlten Gegner sichtbar zum runden Tisch und
setzt ihn hin; danach gehen alle zurueck. Dealer-Regel wie gefordert: spielt
jemand anderes, dealt Ridoc; spielt Ridoc selbst, dealt er sich selbst und
belegt nur den Gegnerplatz. Die Sitzordnung greift vor beiden Spielen, also
auch vorm Messerspiel.

Beim Bauen gefunden: die erste Fassung sammelte die finished-Signale mehrerer
Tweens und wartete sie nacheinander ab — war der erste schon durch, brach das
await ab. Die Sonde meldete trotzdem gruen, weil die Endpositionen stimmten;
erst das Fehlerprotokoll zeigte es. Jetzt laeuft je Phase ein einziger
paralleler Tween.

Verifiziert mit dev_cr17_probe (41/41) und einem Boot-Check ueber zehn
Szenen, Log ohne Laufzeitfehler; Sonde vor dem Commit geloescht.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-21 19:07:36 +02:00
parent bed04dbe92
commit 3381993b71
15 changed files with 703 additions and 77 deletions

179
scripts/ui/card_deck.gd Normal file
View file

@ -0,0 +1,179 @@
class_name CardDeck
extends RefCounted
## Kartenblatt und Blattbewertung fürs Poker (CR 17).
##
## Lädt Farben und Werte aus data/minigames/cards.json, mischt ein volles
## Blatt und bewertet fünf Karten nach den üblichen Poker-Rängen. Bewusst
## ohne Godot-Knoten: Die Anzeige macht card_view.gd, hier liegt nur die
## Rechnung — dadurch kann eine Sonde das Blatt direkt prüfen.
##
## Eine Karte ist ein Dictionary { rank, suit, value, label, symbol,
## is_red }. Ein Blatt ist ein Array aus fünf solchen Karten.
const CARDS_PATH := "res://data/minigames/cards.json"
const HAND_HIGH_CARD := 0
const HAND_PAIR := 1
const HAND_TWO_PAIR := 2
const HAND_TRIPS := 3
const HAND_STRAIGHT := 4
const HAND_FLUSH := 5
const HAND_FULL_HOUSE := 6
const HAND_QUADS := 7
const HAND_STRAIGHT_FLUSH := 8
var suits: Array = []
var ranks: Array = []
var hand_names: Array = []
var texture_dir := ""
var texture_pattern := ""
var _draw_pile: Array = []
## Lädt die Blatt-Daten; liefert false, wenn die Datei fehlt oder kaputt ist.
func load_data() -> bool:
var file := FileAccess.open(CARDS_PATH, FileAccess.READ)
if file == null:
push_error("Kartendaten nicht lesbar: %s" % CARDS_PATH)
return false
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if not (parsed is Dictionary) or not (parsed.get("suits") is Array):
push_error("Kartendaten sind ungültig: %s" % CARDS_PATH)
return false
suits = parsed["suits"]
ranks = parsed["ranks"]
hand_names = parsed.get("hand_names", [])
texture_dir = str(parsed.get("texture_dir", ""))
texture_pattern = str(parsed.get("texture_pattern", ""))
return true
## Baut ein volles, gemischtes Blatt aus allen Farb-Wert-Kombinationen.
func shuffle() -> void:
_draw_pile.clear()
for suit in suits:
for rank in ranks:
_draw_pile.append({
"rank": str(rank.get("id", "")),
"suit": str(suit.get("id", "")),
"value": int(rank.get("value", 0)),
"label": str(rank.get("label", "?")),
"symbol": str(suit.get("symbol", "?")),
"is_red": bool(suit.get("is_red", false)),
})
_draw_pile.shuffle()
## Zieht count Karten vom Stapel.
func draw(count: int) -> Array:
var hand: Array = []
for i in count:
if _draw_pile.is_empty():
break
hand.append(_draw_pile.pop_back())
return hand
## Anzahl der Karten, die noch im Stapel liegen.
func remaining() -> int:
return _draw_pile.size()
## Der Dateipfad zur Grafik einer Karte — existiert er nicht, zeichnet die
## Kartenansicht einen Platzhalter.
func texture_path(card: Dictionary) -> String:
if texture_dir.is_empty() or texture_pattern.is_empty():
return ""
var file_name := texture_pattern.replace("{rank}", str(card.get("rank", ""))).replace("{suit}", str(card.get("suit", "")))
return texture_dir + file_name
## Bewertet fünf Karten. Liefert { category, ranks, name }: category ist
## einer der HAND_-Werte, ranks die absteigend nach Gruppengröße und Wert
## sortierten Kartenwerte für den Stichentscheid.
func evaluate(hand: Array) -> Dictionary:
var values: Array[int] = []
var suit_counts := {}
var value_counts := {}
for card in hand:
var value := int(card.get("value", 0))
values.append(value)
value_counts[value] = int(value_counts.get(value, 0)) + 1
var suit := str(card.get("suit", ""))
suit_counts[suit] = int(suit_counts.get(suit, 0)) + 1
values.sort()
values.reverse()
var is_flush := false
for suit in suit_counts:
if int(suit_counts[suit]) == hand.size():
is_flush = true
var is_straight := _is_straight(values)
var groups: Array = []
for value in value_counts:
groups.append({ "value": int(value), "count": int(value_counts[value]) })
groups.sort_custom(func(a: Dictionary, b: Dictionary) -> bool:
if a["count"] == b["count"]:
return a["value"] > b["value"]
return a["count"] > b["count"])
var ordered: Array[int] = []
for group in groups:
for i in int(group["count"]):
ordered.append(int(group["value"]))
var category := HAND_HIGH_CARD
var top_count := 0 if groups.is_empty() else int(groups[0]["count"])
var second_count := 0 if groups.size() < 2 else int(groups[1]["count"])
if is_straight and is_flush:
category = HAND_STRAIGHT_FLUSH
elif top_count == 4:
category = HAND_QUADS
elif top_count == 3 and second_count == 2:
category = HAND_FULL_HOUSE
elif is_flush:
category = HAND_FLUSH
elif is_straight:
category = HAND_STRAIGHT
elif top_count == 3:
category = HAND_TRIPS
elif top_count == 2 and second_count == 2:
category = HAND_TWO_PAIR
elif top_count == 2:
category = HAND_PAIR
var name := "?"
if category < hand_names.size():
name = str(hand_names[category])
return { "category": category, "ranks": ordered, "name": name }
## Vergleicht zwei bewertete Blätter: 1 wenn das erste gewinnt, −1 wenn das
## zweite gewinnt, 0 bei Gleichstand.
func compare(first: Dictionary, second: Dictionary) -> int:
var a := int(first.get("category", 0))
var b := int(second.get("category", 0))
if a != b:
return 1 if a > b else -1
var ranks_a: Array = first.get("ranks", [])
var ranks_b: Array = second.get("ranks", [])
for i in mini(ranks_a.size(), ranks_b.size()):
if int(ranks_a[i]) != int(ranks_b[i]):
return 1 if int(ranks_a[i]) > int(ranks_b[i]) else -1
return 0
## Prüft auf fünf aufeinanderfolgende Werte; das Ass zählt zusätzlich tief
## (Ass-2-3-4-5, die „kleine Straße").
func _is_straight(sorted_values: Array[int]) -> bool:
var unique: Array[int] = []
for value in sorted_values:
if not value in unique:
unique.append(value)
if unique.size() != 5:
return false
if unique[0] - unique[4] == 4:
return true
return unique == [14, 5, 4, 3, 2]

View file

@ -0,0 +1 @@
uid://dda2yao744yl

101
scripts/ui/card_view.gd Normal file
View file

@ -0,0 +1,101 @@
extends Control
## Anzeige einer einzelnen Spielkarte (CR 17).
##
## Zeigt die PNG aus assets/ui/cards/, sobald der Autor sie geliefert hat
## (Pfad kommt aus data/minigames/cards.json). Fehlt die Datei, zeichnet
## diese Ansicht eine **Platzhalter-Karte**: weißes Rechteck mit Wert und
## Farbzeichen, rot oder schwarz. Beide Zustände sind gleich groß und
## gleich bedienbar — das Spiel wartet nicht auf die Grafiken.
##
## Verdeckte Karten (show_back) zeigen den Rücken; auch dafür gibt es
## einen Platzhalter, damit die Gegnerhand vor dem Showdown zu ist.
const CARD_SIZE := Vector2(64, 92)
const CORNER_RADIUS := 5
var _card: Dictionary = {}
var _is_face_up := true
## Baut die Kinder-Knoten einmalig auf.
func _ready() -> void:
custom_minimum_size = CARD_SIZE
size = CARD_SIZE
## Zeigt eine Karte offen an.
func show_card(card: Dictionary, deck: CardDeck) -> void:
_card = card
_is_face_up = true
_rebuild(deck)
## Zeigt die Rückseite (Gegnerhand vor dem Showdown).
func show_back(deck: CardDeck) -> void:
_card = {}
_is_face_up = false
_rebuild(deck)
## Die aktuell gezeigte Karte (für Sonden).
func get_card() -> Dictionary:
return _card
## Liegt die Karte offen? (für Sonden)
func is_face_up() -> bool:
return _is_face_up
## Baut die Anzeige neu: Textur, wenn vorhanden, sonst Platzhalter.
func _rebuild(deck: CardDeck) -> void:
for child in get_children():
child.queue_free()
var path := ""
if _is_face_up and deck != null:
path = deck.texture_path(_card)
elif deck != null and not deck.texture_dir.is_empty():
path = deck.texture_dir + "ruecken.png"
if not path.is_empty() and ResourceLoader.exists(path):
var texture_rect := TextureRect.new()
texture_rect.texture = load(path)
texture_rect.expand_mode = TextureRect.EXPAND_IGNORE_SIZE
texture_rect.stretch_mode = TextureRect.STRETCH_KEEP_ASPECT_CENTERED
texture_rect.set_anchors_preset(Control.PRESET_FULL_RECT)
add_child(texture_rect)
return
_build_placeholder()
## Zeichnet die Platzhalter-Karte aus Rechteck und Text.
func _build_placeholder() -> void:
var panel := PanelContainer.new()
panel.set_anchors_preset(Control.PRESET_FULL_RECT)
var style := StyleBoxFlat.new()
style.corner_radius_top_left = CORNER_RADIUS
style.corner_radius_top_right = CORNER_RADIUS
style.corner_radius_bottom_left = CORNER_RADIUS
style.corner_radius_bottom_right = CORNER_RADIUS
style.border_width_left = 2
style.border_width_top = 2
style.border_width_right = 2
style.border_width_bottom = 2
if not _is_face_up:
style.bg_color = Color(0.22, 0.26, 0.38)
style.border_color = Color(0.42, 0.46, 0.58)
else:
style.bg_color = Color(0.96, 0.95, 0.91)
style.border_color = Color(0.35, 0.33, 0.3)
panel.add_theme_stylebox_override("panel", style)
add_child(panel)
if not _is_face_up:
return
var label := Label.new()
label.set_anchors_preset(Control.PRESET_FULL_RECT)
label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
label.vertical_alignment = VERTICAL_ALIGNMENT_CENTER
label.text = "%s\n%s" % [str(_card.get("label", "?")), str(_card.get("symbol", "?"))]
label.add_theme_font_size_override("font_size", 22)
var is_red: bool = bool(_card.get("is_red", false))
label.add_theme_color_override("font_color", Color(0.72, 0.16, 0.16) if is_red else Color(0.12, 0.12, 0.14))
add_child(label)

View file

@ -0,0 +1 @@
uid://qk35djhdqj

View file

@ -1,38 +1,53 @@
extends CanvasLayer
## Poker am runden Tisch (CR 13).
## Poker am runden Tisch — mit sichtbaren Karten (CR 17, ersetzt die
## Menü-Variante aus CR 13).
##
## Kein volles Regelwerk, sondern das, worum es beim Pokern in der Aula
## wirklich geht: lesen oder gelesen werden. Jede Runde bekommen beide
## ein Blatt (0–100). Tyrveil sieht sein eigenes und ein **Tell** des
## Gegners — eine Andeutung, die umso öfter lügt, je höher die
## bluff_rate des Gegenübers ist (Imogen blufft, Wren fast nie). Dann:
## mitgehen, erhöhen oder aussteigen.
## Klassische Ansicht: Beide bekommen fünf Karten, die des Gegners liegen
## bis zum Showdown verdeckt. Gespielt wird über echte Setzrunden — der
## Spieler eröffnet (mitgehen, erhöhen, aussteigen), der Gegner antwortet
## darauf mit eigener Entscheidung, dann werden die Blätter aufgedeckt und
## verglichen (CardDeck rechnet die Ränge).
##
## Erhöhen verdoppelt den Einsatz der Runde, Aussteigen kostet nur den
## Ante. play() liefert als Coroutine den Marken-Saldo der Partie; ob
## Tyrveil sich das leisten kann, prüft der Spieltisch vorher.
## Der Gegner spielt wie er ist: `skill` bestimmt, wie gut er sein Blatt
## einschätzt, `bluff_rate`, wie oft er mit schwachem Blatt trotzdem
## erhöht. Imogen blufft am meisten, Wren fast nie.
##
## Die Karten-Grafiken liefert der Autor unter assets/ui/cards/ nach; bis
## dahin zeichnet card_view.gd Platzhalter. Am Ablauf ändert das nichts.
signal acted(action: int)
const CARD_VIEW_SCRIPT := preload("res://scripts/ui/card_view.gd")
const HAND_SIZE := 5
const ACTION_CALL := 0
const ACTION_RAISE := 1
const ACTION_FOLD := 2
const REVEAL_SECONDS := 2.2
var _deck := CardDeck.new()
var _is_open := false
var _own_hand: Array = []
var _their_hand: Array = []
@onready var _title_label: Label = $Root/Panel/Margin/Content/TitleLabel
@onready var _round_label: Label = $Root/Panel/Margin/Content/RoundLabel
@onready var _hand_label: Label = $Root/Panel/Margin/Content/HandLabel
@onready var _round_label: Label = $Root/Panel/Margin/Content/Header/RoundLabel
@onready var _pot_label: Label = $Root/Panel/Margin/Content/Header/PotLabel
@onready var _their_cards: HBoxContainer = $Root/Panel/Margin/Content/TheirRow/TheirCards
@onready var _their_label: Label = $Root/Panel/Margin/Content/TheirRow/TheirLabel
@onready var _own_cards: HBoxContainer = $Root/Panel/Margin/Content/OwnRow/OwnCards
@onready var _own_label: Label = $Root/Panel/Margin/Content/OwnRow/OwnLabel
@onready var _tell_label: Label = $Root/Panel/Margin/Content/TellLabel
@onready var _result_label: Label = $Root/Panel/Margin/Content/ResultLabel
@onready var _actions: HBoxContainer = $Root/Panel/Margin/Content/Actions
@onready var _call_button: Button = $Root/Panel/Margin/Content/Actions/CallButton
@onready var _raise_button: Button = $Root/Panel/Margin/Content/Actions/RaiseButton
@onready var _fold_button: Button = $Root/Panel/Margin/Content/Actions/FoldButton
## Startet verborgen und verbindet die drei Aktionen.
## Startet verborgen, lädt das Blatt und verbindet die Aktionen.
func _ready() -> void:
visible = false
_deck.load_data()
_call_button.pressed.connect(_act.bind(ACTION_CALL))
_raise_button.pressed.connect(_act.bind(ACTION_RAISE))
_fold_button.pressed.connect(_act.bind(ACTION_FOLD))
@ -41,23 +56,14 @@ func _ready() -> void:
## Spielt die Partie (Coroutine) und liefert den Marken-Saldo.
func play(config: Dictionary, opponent: Dictionary) -> int:
_title_label.text = "%s — gegen %s" % [str(config.get("title", "Poker")), str(opponent.get("name", "?"))]
_their_label.text = str(opponent.get("name", "?"))
visible = true
var rounds := int(config.get("rounds", 4))
var ante := int(config.get("ante", 1))
var raise_multiplier := int(config.get("raise_multiplier", 2))
var balance := 0
for index in rounds:
_round_label.text = "Runde %d / %d" % [index + 1, rounds]
var own_hand := randi_range(0, 100)
var their_hand := randi_range(0, 100)
_hand_label.text = "Dein Blatt: %d von 100" % own_hand
_tell_label.text = _tell_for(their_hand, opponent)
_result_label.text = ""
_is_open = true
_call_button.grab_focus.call_deferred()
var action: int = await acted
balance += _resolve(action, own_hand, their_hand, ante, raise_multiplier)
await get_tree().create_timer(1.2).timeout
balance += await _play_round(index, rounds, ante, raise_multiplier, opponent)
visible = false
return balance
@ -67,26 +73,95 @@ func act(action: int) -> void:
_act(action)
## Wertet eine Runde aus und liefert die Marken-Änderung.
func _resolve(action: int, own_hand: int, their_hand: int, ante: int, raise_multiplier: int) -> int:
## Das eigene Blatt der laufenden Runde (für Sonden).
func get_own_hand() -> Array:
return _own_hand
## Das Blatt des Gegners (für Sonden).
func get_their_hand() -> Array:
return _their_hand
## Das Kartenblatt dieser Partie (für Sonden).
func get_deck() -> CardDeck:
return _deck
## Spielt eine Runde: austeilen, Setzrunde, Gegner-Antwort, Showdown.
func _play_round(index: int, rounds: int, ante: int, raise_multiplier: int, opponent: Dictionary) -> int:
_deck.shuffle()
_own_hand = _deck.draw(HAND_SIZE)
_their_hand = _deck.draw(HAND_SIZE)
var own_rating := _deck.evaluate(_own_hand)
var their_rating := _deck.evaluate(_their_hand)
var pot := ante * 2
_round_label.text = "Runde %d / %d" % [index + 1, rounds]
_pot_label.text = "Pott: %d" % pot
_result_label.text = ""
_show_hand(_own_cards, _own_hand, true)
_show_hand(_their_cards, _their_hand, false)
_own_label.text = "Dein Blatt: %s" % str(own_rating.get("name", "?"))
_tell_label.text = _tell_for(their_rating, opponent)
_actions.visible = true
_is_open = true
_call_button.grab_focus.call_deferred()
var action: int = await acted
_actions.visible = false
if action == ACTION_FOLD:
_result_label.text = "Ausgestiegen. −%d Marken." % ante
_result_label.text = "Ausgestiegen. Der Ante bleibt liegen. −%d" % ante
await _pause()
return -ante
var stake := ante * raise_multiplier if action == ACTION_RAISE else ante
if own_hand > their_hand:
_result_label.text = "%d gegen %d — du nimmst den Pott. +%d Marken." % [own_hand, their_hand, stake]
var stake := ante
if action == ACTION_RAISE:
stake = ante * raise_multiplier
var their_action := _decide(their_rating, action, opponent)
if their_action == ACTION_FOLD:
_show_hand(_their_cards, _their_hand, true)
_result_label.text = "%s wirft weg. Der Pott gehört dir. +%d" % [str(opponent.get("name", "?")), stake]
await _pause()
return stake
if own_hand < their_hand:
_result_label.text = "%d gegen %d — der Pott geht rüber. −%d Marken." % [own_hand, their_hand, stake]
if their_action == ACTION_RAISE:
stake *= raise_multiplier
pot = stake * 2
_pot_label.text = "Pott: %d" % pot
_show_hand(_their_cards, _their_hand, true)
_their_label.text = "%s: %s" % [str(opponent.get("name", "?")), str(their_rating.get("name", "?"))]
var outcome := _deck.compare(own_rating, their_rating)
if outcome > 0:
_result_label.text = "%s schlägt %s. +%d" % [str(own_rating.get("name", "?")), str(their_rating.get("name", "?")), stake]
await _pause()
return stake
if outcome < 0:
_result_label.text = "%s schlägt %s. −%d" % [str(their_rating.get("name", "?")), str(own_rating.get("name", "?")), stake]
await _pause()
return -stake
_result_label.text = "%d gegen %d — geteilt." % [own_hand, their_hand]
_result_label.text = "Gleichstand. Der Pott wird geteilt."
await _pause()
return 0
## Baut das Tell des Gegners: mit bluff_rate zeigt es das Gegenteil der
## Wahrheit. Wer oft blufft, ist genau deshalb schwerer zu lesen.
func _tell_for(their_hand: int, opponent: Dictionary) -> String:
var is_strong := their_hand >= 50
## Entscheidet die Antwort des Gegners: Er schätzt sein Blatt nach seinem
## skill ein und erhöht mit schwachem Blatt nur, wenn er blufft.
func _decide(their_rating: Dictionary, player_action: int, opponent: Dictionary) -> int:
var strength := float(their_rating.get("category", 0)) / float(CardDeck.HAND_STRAIGHT_FLUSH)
var judged := lerpf(randf(), strength, float(opponent.get("skill", 0.5)))
var is_bluffing := randf() < float(opponent.get("bluff_rate", 0.3))
if judged < 0.12 and player_action == ACTION_RAISE and not is_bluffing:
return ACTION_FOLD
if judged > 0.45 or is_bluffing:
return ACTION_RAISE
return ACTION_CALL
## Baut das Tell des Gegners: Es zeigt die Wahrheit über sein Blatt, außer
## er blufft gerade — dann zeigt es das Gegenteil.
func _tell_for(their_rating: Dictionary, opponent: Dictionary) -> String:
var is_strong := int(their_rating.get("category", 0)) >= CardDeck.HAND_PAIR
if randf() < float(opponent.get("bluff_rate", 0.3)):
is_strong = not is_strong
var name := str(opponent.get("name", "Dein Gegenüber"))
@ -95,6 +170,25 @@ func _tell_for(their_hand: int, opponent: Dictionary) -> String:
return "%s zählt die eigenen Marken nach. Zum zweiten Mal." % name
## Legt ein Blatt in eine Reihe; is_face_up entscheidet über offen oder zu.
func _show_hand(row: HBoxContainer, hand: Array, is_face_up: bool) -> void:
for child in row.get_children():
child.queue_free()
for card in hand:
var view := Control.new()
view.set_script(CARD_VIEW_SCRIPT)
row.add_child(view)
if is_face_up:
view.show_card(card, _deck)
else:
view.show_back(_deck)
## Lässt das Ergebnis kurz stehen, damit man die Blätter sieht.
func _pause() -> void:
await get_tree().create_timer(REVEAL_SECONDS).timeout
## Meldet die Aktion genau einmal.
func _act(action: int) -> void:
if not _is_open: