feat: pai gow poker added to the casino

9 files changed, 201 insertions, 4 deletions

diff --git a/data/cards.yaml b/data/cards.yaml
index 543d8de..765f53b 100644
--- a/data/cards.yaml
+++ b/data/cards.yaml
@@ -1,4 +1,5 @@
-# Unicode casino card art, shared by every card game (blackjack, baccarat).
+# Unicode casino card art, shared by every card game.
+# JK is the Joker, with explicit art at sizes 1, 5, 7 and 9.
 # Each card defines 7 and 9 line art (5 line cards use the generated renderer:
 # there is no room for a pip layout, so crowded ranks fall back to a single
 # centered suit symbol). Keys are rank plus suit: A/K/Q/J/10/2-9 + C/D/H/S.
@@ -8,6 +9,32 @@
 # AH:
 #   5: ["┌───┐", "│ A │", "│ ♥ │", "│ A │", "└───┘"]
 cards:
+  JK:
+    1: ['JK']
+    5:
+      - '┌───┐'
+      - '│JK │'
+      - '│ ★ │'
+      - '│ JK│'
+      - '└───┘'
+    7:
+      - '┌─────┐'
+      - '│JK   │'
+      - '│ ^ ^ │'
+      - '│(o o)│'
+      - '│  v  │'
+      - '│   JK│'
+      - '└─────┘'
+    9:
+      - '┌───────┐'
+      - '│JK     │'
+      - '│ /\ /\ │'
+      - '│  o o  │'
+      - '│  <J>  │'
+      - '│  \_/  │'
+      - '│   ★   │'
+      - '│     JK│'
+      - '└───────┘'
   AC: {}
   AD: {}
   AH: {}
diff --git a/data/help/casino.yaml b/data/help/casino.yaml
index f401c12..84ea49f 100644
--- a/data/help/casino.yaml
+++ b/data/help/casino.yaml
@@ -1,7 +1,7 @@
 name: casino
 aliases: [play, bet, rebet, table, watch, rules]
 category: Interaction
-related: [roulette, racetrack, blackjack, baccarat, craps, slots, video poker]
+related: [roulette, racetrack, blackjack, baccarat, craps, slots, video poker, pai gow poker]
 description: |
   Casino quick guide
 
@@ -29,5 +29,6 @@ description: |
   help craps         Multiplayer dice, free odds, Fire and ATS bets.
   help slots         Matching symbols, ways and free spins.
   help video poker   Five cabinet types, selectable games, toggle holds and bonuses.
+  help pai gow poker Seven cards, two hands; Classic, EZ, No Push and Fortune/Envy.
 
   Rules and limits vary by table. No bet guarantees a profit.
diff --git a/data/help/pai_gow.yaml b/data/help/pai_gow.yaml
new file mode 100644
index 0000000..a0e21e5
--- /dev/null
+++ b/data/help/pai_gow.yaml
@@ -0,0 +1,60 @@
+name: pai gow poker
+aliases: [pai_gow, paigow, pai gow, ez pai gow poker, no push pai gow poker, face up pai gow, fortune, envy]
+category: Interaction
+related: [casino, video poker]
+description: |
+  Pai Gow Poker — seven cards, two hands
+
+  Find Pai Gow east of the Video Poker Parlor. Classic is in the main salon,
+  EZ north, No Push south, Face Up beyond EZ. play pai joins; rules teaches,
+  table rules displays the exact rules and Fortune payout felt.
+
+  bet 20 places your main wager. Optionally bet 5 fortune BEFORE deal.
+  deal marks you ready; the round starts when all bettors are ready or the
+  betting window ends. Each player and the dealer receive seven cards from
+  a fresh deck with one Joker. Your cards are numbered 1 through 7.
+
+  Type 24 to put cards 2 and 4 in your small (two-card) hand.
+  Type 13456 to put those five cards in your big (five-card) hand instead.
+  Spaces and order do not matter. set 24 also works. No repeated numbers.
+  Your five-card hand must outrank your two-card hand: a foul produces a
+  warning and leaves your hand unset. A valid selection LOCKS your hand.
+  house sets automatically; timeout or disconnect also uses the house way.
+
+  House way preserves the best high-hand category, maximizing low within
+  that category. Two pair/full houses may be split to put pairs in both.
+  The dealer uses this same deterministic house way. It is not a claim
+  of optimal strategy. Full details appear in table rules.
+
+  The Joker acts as an ace, or completes a straight, flush or straight flush.
+  A2345 is the second-highest straight. Low hands have only pairs/high cards.
+  Exact copies lose to the dealer. Win both hands to win the main bet;
+  lose both to lose; otherwise push. Classic charges 5% on winning profit
+  (whole credits rounded down, minimum one credit of profit).
+
+  EZ: no commission; dealer's best five cards exactly queen-high pushes
+  every main bet. This is the partially-wild Joker version.
+  No Push: no commission; split results compare shared player/dealer extra
+  cards. Higher player card wins; ties lose. Joker counts as an ace.
+  Face Up: no commission; the dealer sets and reveals BOTH hands before
+  you set yours. Dealer's best five cards exactly ace-high (a pair of
+  aces does not count) automatically pushes every main bet; the optional
+  Push Ace High side bet pays that push: without Joker 5:1, with Joker
+  15:1, or 40:1 when BOTH sides are ace-high. bet <amount> pushace,
+  up to half your main wager, before deal.
+
+  Fortune uses ALL seven cards, independent of your split and main result.
+  Only the highest listed prize pays, plus your Fortune stake back.
+  Three pair pays 1:1; trips pay 3:1, even with a straight available (2:1).
+  Royal match is a royal flush with a suited king/queen in the other two cards.
+  Exact prizes are printed on the felt. This is published Fortune table 8.
+
+  With Envy enabled, a Fortune bet of at least five also earns fixed awards
+  when OTHER active players have quads or better. Never your own hand, the
+  dealer, or unused seats. Multiple bonuses add. The other player need not
+  bet Fortune. A losing Fortune stake stays lost even when Envy pays.
+  Without Envy, quads improve from 25:1 to 30:1 to compensate modestly.
+
+  stop leaves between rounds. Committed wagers must finish first.
+  A failed bank payment stays pending: settle retries the SAME result,
+  without dealing again. No new round starts until payments finish.
diff --git a/data/rooms/casino/6100.yaml b/data/rooms/casino/6100.yaml
index cf85c90..bcde393 100644
--- a/data/rooms/casino/6100.yaml
+++ b/data/rooms/casino/6100.yaml
@@ -12,7 +12,7 @@ mobs:
 objects:
 - name: wayboard
   description: 'Domita Fortuna in one line: take the stairs up to the gaming street — blackjack,
-    baccarat, roulette, craps, slots, then video poker, going east. Each salon keeps its own house
+    baccarat, roulette, craps, slots, video poker, then Pai Gow Poker, going east. Each salon keeps its own house
     editions in the galleries north and south. The bank booth by the door stores your valuables;
     no wager is needed to explore.'
   inroom_description: A wayboard stands where travelers can read it.
diff --git a/data/rooms/casino/6192.yaml b/data/rooms/casino/6192.yaml
index 2f47b9e..b0419a7 100644
--- a/data/rooms/casino/6192.yaml
+++ b/data/rooms/casino/6192.yaml
@@ -1,8 +1,10 @@
 name: Video Poker Parlor
 description: A row of low-limit single-seat poker cabinets glows blue beneath yellow pay-table borders.
   Classic poker, two Ultimate X editions, Super Times Pay and Hot Roll stand side by side. The high-limit
-  room waits north; the reels are back west.
+  room waits north; the reels are back west and Pai Gow Poker waits east.
 exits:
+  east:
+    room: 6195
   west:
     room: 6118
   north:
diff --git a/data/rooms/casino/6195.yaml b/data/rooms/casino/6195.yaml
new file mode 100644
index 0000000..4e8084d
--- /dev/null
+++ b/data/rooms/casino/6195.yaml
@@ -0,0 +1,29 @@
+name: Fortune Pai Gow Salon
+description: Seven-card fans gleam beneath jade lamps. The green felt displays Fortune
+  prizes beside a pair of small and large hand boxes. EZ Pai Gow waits north and
+  No Push south; the video poker cabinets glow to the west.
+exits:
+  west:
+    room: 6192
+  north:
+    room: 6196
+  south:
+    room: 6197
+casino_tables:
+- id: fortune
+  game: pai_gow
+  max_players: 6
+  min_bet: 5
+  max_bet: 1000
+  betting_ticks: 30
+  pai_gow:
+    variant: classic
+    envy: true
+    action_ticks: 60
+objects:
+- name: fortune plaque
+  description: 'play pai; bet 20, optionally bet 5 fortune, then deal. Set two low cards
+    with 24 or five high cards with 13456; house sets automatically. High must beat low.
+    Classic wins pay 0.95:1. Fortune pays independently; five credits qualifies for Envy
+    on other active players. table rules shows the payout felt.'
+  inroom_description: A jade fortune plaque explains the table.
diff --git a/data/rooms/casino/6196.yaml b/data/rooms/casino/6196.yaml
new file mode 100644
index 0000000..07dd081
--- /dev/null
+++ b/data/rooms/casino/6196.yaml
@@ -0,0 +1,27 @@
+name: EZ Pai Gow Gallery
+description: A queen of jade watches over a commission-free Pai Gow table. The felt
+  warns that a dealer queen-high pushes the main bets. Face Up Pai Gow waits north
+  and the Fortune salon south.
+exits:
+  south:
+    room: 6195
+  north:
+    room: 6198
+casino_tables:
+- id: ez
+  game: pai_gow
+  max_players: 6
+  min_bet: 5
+  max_bet: 1000
+  betting_ticks: 30
+  pai_gow:
+    variant: ez
+    envy: true
+    action_ticks: 60
+objects:
+- name: ez plaque
+  description: 'play pai; main wins pay 1:1, but a dealer queen-high pushes. The Joker is
+    an ace or completes a straight or flush. bet 20, optionally bet 5 fortune, then deal.
+    Set your low hand with two numbers or high with five; house sets automatically.
+    table rules shows Fortune payouts and fixed Envy awards.'
+  inroom_description: A queen-shaped plaque marks the EZ rules.
diff --git a/data/rooms/casino/6197.yaml b/data/rooms/casino/6197.yaml
new file mode 100644
index 0000000..fabbc75
--- /dev/null
+++ b/data/rooms/casino/6197.yaml
@@ -0,0 +1,25 @@
+name: No Push Pai Gow Gallery
+description: Two extra card boxes sit above the dealer's hand on a jade-green felt.
+  Here every main wager wins or loses; even a split result has a tiebreaker.
+  The Fortune salon is north.
+exits:
+  north:
+    room: 6195
+casino_tables:
+- id: no_push
+  game: pai_gow
+  max_players: 6
+  min_bet: 5
+  max_bet: 1000
+  betting_ticks: 30
+  pai_gow:
+    variant: no_push
+    envy: false
+    action_ticks: 60
+objects:
+- name: no push plaque
+  description: 'play pai; bet 20, optionally bet 5 fortune, then deal. Two numbers set
+    your low hand; five set your high hand; house sets automatically. Main wins pay 1:1.
+    Split results compare two extra cards: player must be higher, ties lose, Joker is ace.
+    Envy is off here, so Fortune quads improve to 30:1. table rules shows all prizes.'
+  inroom_description: A two-card plaque explains the tiebreaker.
diff --git a/data/rooms/casino/6198.yaml b/data/rooms/casino/6198.yaml
new file mode 100644
index 0000000..e60b5dd
--- /dev/null
+++ b/data/rooms/casino/6198.yaml
@@ -0,0 +1,26 @@
+name: Face Up Pai Gow Parlor
+description: Seven-card fans face a glass dealer rail; the dealer's cards are turned
+  face up here. The felt warns that a dealer ace-high pai gow pushes every main
+  bet, and offers the Push Ace High side bet. EZ Pai Gow waits south.
+exits:
+  south:
+    room: 6196
+casino_tables:
+- id: face_up
+  game: pai_gow
+  max_players: 6
+  min_bet: 5
+  max_bet: 1000
+  betting_ticks: 30
+  pai_gow:
+    variant: face_up
+    push_ace_high: 5_15_40
+    envy: true
+    action_ticks: 60
+objects:
+- name: face up plaque
+  description: 'play pai; bet 20, optionally bet 5 fortune and/or bet 10 pushace, then
+    deal. The dealer sets and reveals first; dealer ace-high pai gow pushes main bets.
+    Push Ace High pays 5:1 (no Joker), 15:1 (with Joker) or 40:1 (both ace-high).
+    Set two low numbers or five high; house sets automatically. table rules shows the felt.'
+  inroom_description: A glass-rail plaque explains the face-up rules.