2 files changed, 62 insertions, 1 deletions
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.