feat: look, rules, and list commands updated for casino games

13 files changed, 196 insertions, 31 deletions

diff --git a/data/help/baccarat.yaml b/data/help/baccarat.yaml
index b8d0e56..951e2f2 100644
--- a/data/help/baccarat.yaml
+++ b/data/help/baccarat.yaml
@@ -26,4 +26,5 @@ description: |
 
   Side bets settle independently; a pair can win even on a tie.
   Higher payouts do not mean better value: rare events win less often.
-  table rules shows this table's exact payouts and available bets.
+  Typing rules at the table shows this page again; table rules shows
+  this table's exact payouts and available bets.
diff --git a/data/help/blackjack.yaml b/data/help/blackjack.yaml
index 3e4c2c8..1f34b1a 100644
--- a/data/help/blackjack.yaml
+++ b/data/help/blackjack.yaml
@@ -23,4 +23,5 @@ description: |
 
   table rules lists the actual blackjack payout, insurance payout,
   dealer soft-17 rule, splitting restrictions and surrender availability.
-  table help shows controls; help casino explains wagers and returns.
+  Typing rules at the table shows this page again; help casino explains
+  wagers and returns.
diff --git a/data/help/casino.yaml b/data/help/casino.yaml
index 1ff11a7..b9756cb 100644
--- a/data/help/casino.yaml
+++ b/data/help/casino.yaml
@@ -1,5 +1,5 @@
 name: casino
-aliases: [play, bet, rebet, table, watch]
+aliases: [play, bet, rebet, table, watch, rules]
 category: Interaction
 related: [roulette, racetrack, blackjack, baccarat, craps, slots]
 description: |
@@ -10,7 +10,9 @@ description: |
   bet 10 on <target> Choose a roulette, baccarat or craps bet.
   bet / rebet        Repeat your last table wager.
   table              Show the table; roulette also shows payout tables.
-  table help         Learn the current game and its controls.
+  rules              The help page for the game you're playing — every
+                     house edition has its own short page.
+  list               Every bet accepted right now, with payouts.
   table rules        Check this table's exact rules and payouts.
   stop               Leave (after a committed table round).
 
diff --git a/data/help/crapless_craps.yaml b/data/help/crapless_craps.yaml
new file mode 100644
index 0000000..f05364a
--- /dev/null
+++ b/data/help/crapless_craps.yaml
@@ -0,0 +1,26 @@
+name: crapless craps
+aliases: [crapless]
+category: Interaction
+related: [craps, casino]
+description: |
+  Crapless Craps — the come-out 7 is the only loser.
+
+    play crapless craps     Sit down
+    bet 10 on pass          1:1; come-out 7 wins, EVERY other total
+                            (2,3,4,5,6,8,9,10,11,12) becomes the point
+    bet 10 on come          A personal point, once a table point is ON
+    bet 30 on odds pass     True odds behind your point (default 1x on
+                            extra numbers 2/3/11/12, 3-4-5x elsewhere)
+    bet 12 on place 6       Also 4/5/8/9/10; 2/12 pay 11:2, 3/11 pay 11:4
+    bet 20 on buy 4         True odds; 5% stake commission, wins only
+    bet 40 on lay 10        True odds laid; 5% profit commission
+    bet 10 on field / hard 6 / seven / eleven / horn / hop 2 3
+    roll / autoroll         Shoot now / roll on your turn automatically
+    table / list / rules    Felt / bets and payouts / this page
+    unbet place 6           Return optional bets or odds before the roll
+    stop / sitout           Leave / sit out once bets settle
+
+  No don't bets and no Fire/All/Tall/Small bonuses: with no losing
+  come-out, don't bets would be unplayable and bonuses unbeatable.
+  Place/buy/hardways and come odds are off on come-out; lay always
+  works. Commission rounds up; contracts cannot be removed.
diff --git a/data/help/craps.yaml b/data/help/craps.yaml
index 3537a80..2e1c826 100644
--- a/data/help/craps.yaml
+++ b/data/help/craps.yaml
@@ -1,15 +1,14 @@
 name: craps
 aliases: [roll, autoroll, unbet]
 category: Interaction
-related: [casino, roulette]
+related: [casino, roulette, simplified craps, high point craps, crapless craps, new york craps, die rich craps, diceless craps]
 description: |
   Craps — multiplayer house editions at the Domita Fortuna casino.
   From single-zero roulette, east reaches Bank Craps. North of the pit
   waits Simplified, High Point, then Crapless; south waits New York,
-  Die Rich, then Diceless. Join with play craps in each room; table
-  rules gives that edition's exact targets and payouts. The examples
-  below are BANK rules, not a promise that every edition accepts every
-  bet.
+  Die Rich, then Diceless. Join with play craps in each room. The
+  page below is the BANK edition; every edition has a short help page
+  of its own — type rules at any table, or help <edition name>.
 
   play craps              Join the tail of the shooting queue
   watch craps             Watch without betting
@@ -69,24 +68,6 @@ description: |
   or 3:1 according to table rules. Pass/come and bonus contracts cannot
   be removed. Disconnecting forfeits live bets; shutdown refunds them.
 
-  HOUSE EDITIONS (regional versions may differ):
-  Simplified: pass only, one roll of two dice. The dice roll automatically
-  3 seconds after the first bet; there is no manual roll. Bet with
-  'bet <amount>' (always pass; a bare bet repeats your last wager).
-  2 pays 3:1; 3/4 pay 1:1; 10/11 pay 2:1; 12 pays 5:1. 5/6/7/8/9 lose.
-  No point, odds or side bets. House edge: 2.78%.
-  High Point: pass only, 1:1. Come-out 2/3 roll again; 11/12 win;
-  4-10 become the point. The next roll must EXCEED it to win.
-  Die Rich: pass only, ONE die, 1:1. Come-out 6 wins; 1 loses;
-  2-5 become points. Repeat the point before 1 to win.
-  These three have no odds or side bets; a loss passes the dice.
-  Crapless: only 7 wins on come-out; every other total becomes a
-  point. Pass/come, odds and bank side bets, but NO don't or bonus bets.
-  Place 2/12 pays 11:2; 3/11 pays 11:4. True odds 2/12 pay 6:1;
-  3/11 pay 3:1 (lay inverses). Default extra-number odds limit is 1x.
-  New York: bank pass/dontpass, free odds, buy and lay ONLY. Win-only
-  5% buy-stake / lay-profit commission, rounded up. No come or bonuses.
-  Diceless: full bank rules, but two independent packs of six cards
-  numbered 1-6 replace dice. Draw one from each; replace and reshuffle
-  BOTH packs after EVERY draw. All 36 ordered pairs are equally likely;
-  there is no finite shoe. Cards are displayed as cards, not dice.
+  HOUSE EDITIONS have their own help pages — simplified craps, high
+  point craps, die rich craps, crapless craps, new york craps and
+  diceless craps. Type rules while seated at that table.
diff --git a/data/help/diceless_craps.yaml b/data/help/diceless_craps.yaml
new file mode 100644
index 0000000..61348f6
--- /dev/null
+++ b/data/help/diceless_craps.yaml
@@ -0,0 +1,20 @@
+name: diceless craps
+aliases: [diceless]
+category: Interaction
+related: [craps, casino]
+description: |
+  Diceless Craps — full bank rules, dealt from cards.
+
+    play diceless craps     Sit down
+    bet 10 on pass          Every bank bet works (see help craps)
+    table / list / rules    Felt / bets and payouts / this page
+
+  Two independent packs of six cards numbered 1-6 replace the dice.
+  Each roll draws one card from each pack, then replaces and
+  reshuffles BOTH packs — so every one of the 36 ordered pairs stays
+  equally likely on every single roll. There is no finite shoe and
+  nothing to count; counting systems do not apply.
+
+  Cards are displayed as cards, not dice, and each pack keeps its own
+  draw. Bets, odds, payouts and timers are exactly the bank craps
+  rules; help craps covers every wager, and rules repeats this page.
diff --git a/data/help/die_rich_craps.yaml b/data/help/die_rich_craps.yaml
new file mode 100644
index 0000000..e723598
--- /dev/null
+++ b/data/help/die_rich_craps.yaml
@@ -0,0 +1,21 @@
+name: die rich craps
+aliases: [die rich]
+category: Interaction
+related: [craps, casino]
+description: |
+  Die Rich Craps — pass only, played with a single die.
+
+    play die rich craps     Sit down
+    bet 10 on pass          The only bet; pays 1:1
+    roll / autoroll         Shoot now / roll on your turn automatically
+    table / list / rules    Felt / bets and payouts / this page
+    stop / sitout           Leave / sit out once bets settle
+
+  Come-out 6 wins immediately and 1 loses immediately; totals 2-5
+  become the point. Repeat the point before rolling a 1 to win; any
+  other face rolls again, and a 1 kills every line bet and passes
+  the die.
+
+  No odds, no come bets, no side bets. Bets stay open until the roll;
+  multiplayer gives 10 seconds to bet, then the dealer rolls for a
+  shooter who waits another 60 seconds.
diff --git a/data/help/ez_baccarat.yaml b/data/help/ez_baccarat.yaml
new file mode 100644
index 0000000..bfa51c3
--- /dev/null
+++ b/data/help/ez_baccarat.yaml
@@ -0,0 +1,22 @@
+name: ez baccarat
+aliases: [ez]
+category: Interaction
+related: [baccarat, casino]
+description: |
+  EZ Baccarat — no commission; the Banker three-card 7 pushes.
+
+  play ez baccarat           Sit down (or play baccarat in that salon)
+  bet 100 on banker          Banker wins pay 1:1, EXCEPT a winning
+                             three-card 7 pushes Banker bets
+  bet 100 on player          1:1; ties push (and still lose to a
+                             pushing three-card Banker 7)
+  bet 100 on tie             8:1 on this table
+  bet 100 on dragon_7        40:1; Banker wins with a three-card 7
+  bet 100 on panda_8         25:1; Player wins with a three-card 8
+  bet 100 on player_pair / banker_pair   11:1 each
+  table / list / rules       The table / bets and payouts / this page
+  stop / sitout              Leave / sit out after this round
+
+  One wager per round. Highest last digit of the total wins (aces = 1,
+  tens = 0); drawing is automatic. help baccarat covers the shared
+  rules.
diff --git a/data/help/high_point_craps.yaml b/data/help/high_point_craps.yaml
new file mode 100644
index 0000000..7e35319
--- /dev/null
+++ b/data/help/high_point_craps.yaml
@@ -0,0 +1,20 @@
+name: high point craps
+aliases: [high point]
+category: Interaction
+related: [craps, casino]
+description: |
+  High Point Craps — pass only, and low totals can never win.
+
+    play high point craps   Sit down (salon north of the bank pit)
+    bet 10 on pass          The only bet; pays 1:1
+    roll / autoroll         Shoot now / roll on your turn automatically
+    table / list / rules    Felt / bets and payouts / this page
+    stop / sitout           Leave / sit out once bets settle
+
+  The come-out 2 or 3 rolls again (nothing lost); 11 and 12 win
+  outright; 4-10 become the point. The next roll wins only if it is
+  HIGHER than the point — equal or lower loses, and the dice pass.
+
+  No odds, no come bets, no side bets. Bets stay open until the roll;
+  multiplayer gives 10 seconds to bet, then the dealer rolls for a
+  shooter who waits another 60 seconds.
diff --git a/data/help/new_york_craps.yaml b/data/help/new_york_craps.yaml
new file mode 100644
index 0000000..ae3a053
--- /dev/null
+++ b/data/help/new_york_craps.yaml
@@ -0,0 +1,22 @@
+name: new york craps
+aliases: [new york]
+category: Interaction
+related: [craps, casino]
+description: |
+  New York Craps — line bets and commission odds only.
+
+    play new york craps     Sit down
+    bet 10 on pass          Come-out 7/11 win; 2/3/12 lose; then point
+    bet 10 on dontpass      Opposite side; come-out 12 pushes
+    bet 30 on odds pass     Free odds behind your point (true odds)
+    bet 30 on odds dontpass Free odds laid against the point
+    bet 20 on buy 4         True odds; 5% STAKE commission, wins only
+    bet 40 on lay 10        True odds against the number; 5% WIN commission
+    roll / autoroll         Shoot now / roll on your turn automatically
+    table / list / rules    Felt / bets and payouts / this page
+    stop / sitout           Leave / sit out once bets settle
+
+  No come, place, field, hardway, proposition or bonus bets — the
+  entire game is pass/don't pass with buy and lay behind them.
+  Buy is off on come-out; lay works from the start. Commission
+  rounds up to a credit. Bets stay open until the roll.
diff --git a/data/help/roulette.yaml b/data/help/roulette.yaml
index a6f4c23..c789ae6 100644
--- a/data/help/roulette.yaml
+++ b/data/help/roulette.yaml
@@ -50,7 +50,8 @@ description: |
                           on the wheel (9 chips)
 
   Use help racetrack for the chip placements and each call bet's payouts.
-  Use table for a formatted payout reference for your current wheel.
+  Typing rules at the table shows this page again; table gives a
+  formatted payout reference for your current wheel.
 
   Call-bet returns depend on which chip placements win; overlapping
   wins are added together. Fractional credit returns are rounded down.
diff --git a/data/help/simplified_craps.yaml b/data/help/simplified_craps.yaml
new file mode 100644
index 0000000..55f4822
--- /dev/null
+++ b/data/help/simplified_craps.yaml
@@ -0,0 +1,27 @@
+name: simplified craps
+aliases: [simplified]
+category: Interaction
+related: [craps, casino]
+description: |
+  Simplified Craps — the shortest table in the casino.
+
+  One bet (pass), one roll of two dice, and the dice roll themselves
+  3 seconds after your bet. There is no roll command and no waiting
+  for other players: everyone bets their own pass line, every round.
+
+    bet 10            Wager on pass (the only bet there is)
+    bet / rebet       Repeat your last wager
+    table             The felt, the dice and your open wager
+    list              This game's bets and payouts
+    rules             This page
+    stop / sitout     Leave / sit out once your bet settles
+
+  How each total pays (stake returns with every win):
+    2                 3:1
+    3 or 4            1:1
+    10 or 11          2:1
+    12                5:1
+    5, 6, 7, 8 or 9   lose
+
+  There is no point, no odds, no come bets and no side bets. A loss
+  passes the dice to the next shooter. House edge: 2.78%.
diff --git a/data/help/super6_baccarat.yaml b/data/help/super6_baccarat.yaml
new file mode 100644
index 0000000..f8940b8
--- /dev/null
+++ b/data/help/super6_baccarat.yaml
@@ -0,0 +1,21 @@
+name: super 6 baccarat
+aliases: [super 6]
+category: Interaction
+related: [baccarat, casino]
+description: |
+  Super 6 Baccarat — no commission; Banker sixes pay half.
+
+  play super 6 baccarat      Sit down (or play baccarat in that salon)
+  bet 25 on banker           Banker wins pay 1:1, EXCEPT a winning 6
+                             pays 1:2 (two or three cards)
+  bet 25 on player           1:1; ties push
+  bet 25 on tie              9:1 on this table
+  bet 25 on player_pair      11:1; first two Player cards share a rank
+  bet 25 on banker_pair      11:1; first two Banker cards share a rank
+  bet 25 on super_6          12:1; Banker wins with 6
+  table / list / rules       The table / bets and payouts / this page
+  stop / sitout              Leave / sit out after this round
+
+  One wager per round. Player bets still lose when a Banker 6 halves.
+  Highest last digit of the total wins (aces = 1, tens = 0); drawing
+  is automatic. help baccarat covers the shared rules.