feat: video poker machines added to casino

16 files changed, 281 insertions, 3 deletions

diff --git a/data/help/bonus_poker.yaml b/data/help/bonus_poker.yaml
new file mode 100644
index 0000000..65d949b
--- /dev/null
+++ b/data/help/bonus_poker.yaml
@@ -0,0 +1,14 @@
+name: bonus poker
+category: Interaction
+related: [video poker, casino]
+description: |
+  Bonus Poker
+
+  A pair of jacks or better is the lowest win. Two pair pays 2 per coin.
+  Four aces pay 80, four 2s-4s pay 40, and four 5s-Ks pay 25 per coin.
+
+  Select this game inside a compatible video poker cabinet with game bonus_poker.
+  payout low|normal|full selects a published pay schedule, not a different game.
+  paytable shows exact returns and any next-hand multiplier awards.
+  Type 531 or 1 3 5 to toggle holds, then draw or d. See help video poker
+  for denominations, loading coins, supported hands and bonus cabinets.
diff --git a/data/help/bonus_poker_deluxe.yaml b/data/help/bonus_poker_deluxe.yaml
new file mode 100644
index 0000000..40f5234
--- /dev/null
+++ b/data/help/bonus_poker_deluxe.yaml
@@ -0,0 +1,14 @@
+name: bonus poker deluxe
+category: Interaction
+related: [video poker, casino]
+description: |
+  Bonus Poker Deluxe
+
+  A pair of jacks or better is the lowest win. All four-of-a-kind hands
+  pay 80 per coin; two pair pays only 1 per coin.
+
+  Select this game inside a compatible video poker cabinet with game bonus_poker_deluxe.
+  payout low|normal|full selects a published pay schedule, not a different game.
+  paytable shows exact returns and any next-hand multiplier awards.
+  Type 531 or 1 3 5 to toggle holds, then draw or d. See help video poker
+  for denominations, loading coins, supported hands and bonus cabinets.
diff --git a/data/help/casino.yaml b/data/help/casino.yaml
index b9756cb..f401c12 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]
+related: [roulette, racetrack, blackjack, baccarat, craps, slots, video poker]
 description: |
   Casino quick guide
 
@@ -18,7 +18,7 @@ description: |
 
   Profit odds exclude your returned stake: a 10-credit win at 2:1
   returns 30 total (20 profit + 10 stake). A push returns the stake;
-  a loss returns nothing. Slots report total returns, not profit odds.
+  a loss returns nothing. Slots and video poker report total returns, not profit odds.
   Fractional table-game returns round down to whole credits, except
   craps which requires exact payout units (commission rounds up).
 
@@ -28,5 +28,6 @@ description: |
   help baccarat      Bet which hand finishes closest to 9.
   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.
 
   Rules and limits vary by table. No bet guarantees a profit.
diff --git a/data/help/deuces_wild.yaml b/data/help/deuces_wild.yaml
new file mode 100644
index 0000000..39725cb
--- /dev/null
+++ b/data/help/deuces_wild.yaml
@@ -0,0 +1,15 @@
+name: deuces wild
+category: Interaction
+related: [video poker, casino]
+description: |
+  Deuces Wild
+
+  Every 2 is wild. Three of a kind is the lowest win; two pair does not
+  pay. Four deuces pay 200 per coin. Natural and wild royals are separate
+  categories. Wild cards form the highest-paying hand on the selected table.
+
+  Select this game inside a compatible video poker cabinet with game deuces_wild.
+  payout low|normal|full selects a published pay schedule, not a different game.
+  paytable shows exact returns and any next-hand multiplier awards.
+  Type 531 or 1 3 5 to toggle holds, then draw or d. See help video poker
+  for denominations, loading coins, supported hands and bonus cabinets.
diff --git a/data/help/double_bonus.yaml b/data/help/double_bonus.yaml
new file mode 100644
index 0000000..d09b373
--- /dev/null
+++ b/data/help/double_bonus.yaml
@@ -0,0 +1,15 @@
+name: double bonus
+category: Interaction
+related: [video poker, casino]
+description: |
+  Double Bonus
+
+  A pair of jacks or better is the lowest win. Four aces pay 160, four
+  2s-4s pay 80, and four 5s-Ks pay 50 per coin. Two pair pays 1.
+  Straight, full-house and flush rates depend on the selected schedule.
+
+  Select this game inside a compatible video poker cabinet with game double_bonus.
+  payout low|normal|full selects a published pay schedule, not a different game.
+  paytable shows exact returns and any next-hand multiplier awards.
+  Type 531 or 1 3 5 to toggle holds, then draw or d. See help video poker
+  for denominations, loading coins, supported hands and bonus cabinets.
diff --git a/data/help/double_double_bonus.yaml b/data/help/double_double_bonus.yaml
new file mode 100644
index 0000000..4365694
--- /dev/null
+++ b/data/help/double_double_bonus.yaml
@@ -0,0 +1,15 @@
+name: double double bonus
+category: Interaction
+related: [video poker, casino]
+description: |
+  Double Double Bonus
+
+  A pair of jacks or better is the lowest win. Four aces with a 2-4 kicker
+  pay 400 per coin; otherwise 160. Four 2s-4s with an A-4 kicker pay 160,
+  otherwise 80. Four 5s-Ks pay 50; two pair pays 1 per coin.
+
+  Select this game inside a compatible video poker cabinet with game double_double_bonus.
+  payout low|normal|full selects a published pay schedule, not a different game.
+  paytable shows exact returns and any next-hand multiplier awards.
+  Type 531 or 1 3 5 to toggle holds, then draw or d. See help video poker
+  for denominations, loading coins, supported hands and bonus cabinets.
diff --git a/data/help/hot_roll.yaml b/data/help/hot_roll.yaml
new file mode 100644
index 0000000..0e6f483
--- /dev/null
+++ b/data/help/hot_roll.yaml
@@ -0,0 +1,19 @@
+name: hot roll
+category: Interaction
+related: [video poker, casino]
+description: |
+  Hot Roll
+
+  Choose hands 3, 5 or 10. Games: jacks, ddb.
+  game lists games; game <name> selects one. payout low|normal|full sets
+  the same quality tier across games. paytable shows the exact schedule.
+
+  Feature ON adds five coins per hand to a five-coin base wager (10 total).
+  Before dealing, a 1-in-6 trigger rolls two fair dice. Their sum multiplies
+  every line this round. There is no next-hand multiplier bank.
+
+  feature on|off is available between rounds. denom 1|10|50 selects credits
+  per coin. bet 1-4 adds coins; bet max loads five; bare bet repeats silently.
+  deal charges and deals. 531 or 1 3 5 toggles holds; draw or d finishes.
+  stop leaves between rounds. rules opens this guide; help video poker
+  explains all controls and base game help pages explain winning hands.
diff --git a/data/help/jacks_or_better.yaml b/data/help/jacks_or_better.yaml
new file mode 100644
index 0000000..4ece68d
--- /dev/null
+++ b/data/help/jacks_or_better.yaml
@@ -0,0 +1,14 @@
+name: jacks or better
+category: Interaction
+related: [video poker, casino]
+description: |
+  Jacks or Better
+
+  A pair of jacks, queens, kings or aces is the lowest win. Two pair pays
+  2 per coin; four of a kind pays 25. Natural royals pay 4000 at five coins.
+
+  Select this game inside a compatible video poker cabinet with game jacks_or_better.
+  payout low|normal|full selects a published pay schedule, not a different game.
+  paytable shows exact returns and any next-hand multiplier awards.
+  Type 531 or 1 3 5 to toggle holds, then draw or d. See help video poker
+  for denominations, loading coins, supported hands and bonus cabinets.
diff --git a/data/help/joker_poker.yaml b/data/help/joker_poker.yaml
new file mode 100644
index 0000000..8783507
--- /dev/null
+++ b/data/help/joker_poker.yaml
@@ -0,0 +1,15 @@
+name: joker poker
+category: Interaction
+related: [video poker, casino]
+description: |
+  Joker Poker (Kings or Better)
+
+  A 53-card deck includes one wild joker. Kings or aces are the lowest
+  paying pair. Natural and wild royals are separate; five of a kind is
+  possible. This is Kings or Better, not the Two Pair version.
+
+  Select this game inside a compatible video poker cabinet with game joker_poker.
+  payout low|normal|full selects a published pay schedule, not a different game.
+  paytable shows exact returns and any next-hand multiplier awards.
+  Type 531 or 1 3 5 to toggle holds, then draw or d. See help video poker
+  for denominations, loading coins, supported hands and bonus cabinets.
diff --git a/data/help/super_times_pay.yaml b/data/help/super_times_pay.yaml
new file mode 100644
index 0000000..0d9f92b
--- /dev/null
+++ b/data/help/super_times_pay.yaml
@@ -0,0 +1,20 @@
+name: super times pay
+category: Interaction
+related: [video poker, casino]
+description: |
+  Super Times Pay
+
+  Choose hands 1, 3, 5 or 10. Games: jacks, bonus, double, ddb, deuces.
+  game lists games; game <name> selects one. payout low|normal|full sets
+  the same quality tier across games. paytable shows the exact schedule.
+
+  Feature ON adds one coin per hand to a five-coin base wager (6 total).
+  Before dealing, a 1-in-15 trigger awards one multiplier for ALL lines.
+  Conditional chances for 2x/3x/4x/5x/8x/10x are 17/33/16/24/6/4 percent.
+  There is no next-hand multiplier bank.
+
+  feature on|off is available between rounds. denom 1|10|50 selects credits
+  per coin. bet 1-4 adds coins; bet max loads five; bare bet repeats silently.
+  deal charges and deals. 531 or 1 3 5 toggles holds; draw or d finishes.
+  stop leaves between rounds. rules opens this guide; help video poker
+  explains all controls and base game help pages explain winning hands.
diff --git a/data/help/ultimate_x_multi_hand.yaml b/data/help/ultimate_x_multi_hand.yaml
new file mode 100644
index 0000000..cffdc33
--- /dev/null
+++ b/data/help/ultimate_x_multi_hand.yaml
@@ -0,0 +1,23 @@
+name: ultimate x multi hand
+category: Interaction
+related: [video poker, casino]
+description: |
+  Ultimate X Multi-Hand
+
+  Choose hands 3, 5 or 10. Games: jacks, deluxe, double, ddb, deuces, joker.
+  game lists games; game <name> selects one. payout low|normal|full sets
+  the same quality tier across games. paytable shows the exact schedule.
+
+  Feature ON adds five coins per hand to a five-coin base wager. Each winning
+  line earns its own NEXT-hand multiplier. The NEXT X column changes with
+  hand count. A current multiplier never multiplies another multiplier.
+
+  Multipliers belong to the machine, not you. Another player inherits them.
+  Banks are separate for each game, tier, denomination and hand count, and
+  survive restarts. Feature OFF can collect a bank without earning new awards.
+
+  feature on|off is available between rounds. denom 1|10|50 selects credits
+  per coin. bet 1-4 adds coins; bet max loads five; bare bet repeats silently.
+  deal charges and deals. 531 or 1 3 5 toggles holds; draw or d finishes.
+  stop leaves between rounds. rules opens this guide; help video poker
+  explains all controls and base game help pages explain winning hands.
diff --git a/data/help/ultimate_x_single_line.yaml b/data/help/ultimate_x_single_line.yaml
new file mode 100644
index 0000000..139fe2a
--- /dev/null
+++ b/data/help/ultimate_x_single_line.yaml
@@ -0,0 +1,23 @@
+name: ultimate x single line
+category: Interaction
+related: [video poker, casino]
+description: |
+  Ultimate X Single Line
+
+  One hand. Games: jacks, bonus, deluxe, double, ddb, deuces, joker.
+  game lists games; game <name> selects one. payout low|normal|full sets
+  the same quality tier across games. paytable shows the exact schedule.
+
+  Feature ON adds five coins to a five-coin wager. Winning hands earn the NEXT
+  hand's multiplier; current multipliers never multiply new awards. The NEXT X
+  column shows awards. Single-line awards differ from multi-hand awards.
+
+  Multipliers belong to the machine, not you. Another player inherits them.
+  Banks are separate for each game, tier, denomination and hand count, and
+  survive restarts. Feature OFF can collect a bank without earning new awards.
+
+  feature on|off is available between rounds. denom 1|10|50 selects credits
+  per coin. bet 1-4 adds coins; bet max loads five; bare bet repeats silently.
+  deal charges and deals. 531 or 1 3 5 toggles holds; draw or d finishes.
+  stop leaves between rounds. rules opens this guide; help video poker
+  explains all controls and base game help pages explain winning hands.
diff --git a/data/help/video_poker.yaml b/data/help/video_poker.yaml
new file mode 100644
index 0000000..5cd8c77
--- /dev/null
+++ b/data/help/video_poker.yaml
@@ -0,0 +1,48 @@
+name: video poker
+aliases: [video_poker, vp, poker, denom, denomination, paytable]
+category: Interaction
+related: [casino, ultimate x single line, ultimate x multi hand, super times pay, hot roll, jacks or better, bonus poker, bonus poker deluxe, double bonus, double double bonus, deuces wild, joker poker]
+description: |
+  Video Poker — five cabinet types
+
+  The lounge east of Penny Reels has Classic Video Poker, Ultimate X Single
+  Line, Ultimate X Multi-Hand, Super Times Pay and Hot Roll. Each has one seat.
+  play lists cabinets; play <id> seats you. game lists its supported games.
+  game jacks selects Jacks or Better. Other short names: bonus, deluxe,
+  double, ddb, deuces, joker. Full game names and underscore names also work.
+  Not every feature supports every game. Joker Poker is Kings or Better.
+
+  payout low|normal|full sets the cabinet-wide pay quality for ALL its games.
+  These select published schedules, not different games or guaranteed RTPs.
+  paytable shows the selected game, schedule and exact coin payouts.
+  hands lists supported counts; hands <count> selects one between rounds.
+  Classic Jacks supports 1/3/5/10/25/50/100 hands; other classic games use 1.
+  Ultimate X Single uses 1, Ultimate X Multi and Hot Roll 3/5/10,
+  and Super Times Pay 1/3/5/10. Larger games use smaller card art.
+
+  denom 1|10|50 (or denomination) sets credits per coin.
+  bet 1-4 ADDS coins, capped at five per hand; bet max loads five.
+  Bare bet repeats your previous selection, or five initially, without
+  reprinting the pay table. Explicit bets reprint it with a red coin column.
+  Loading coins does not charge money or reveal cards. deal pays and deals.
+
+  Type 531, 1 3 5, or hold 531 to TOGGLE those cards. Type a number again
+  to release it. Repeated digits in one command toggle only once.
+  There is no hold none command. draw or d replaces unheld cards once;
+  away from video poker, d still means down. HELD labels are bold yellow.
+  Each line draws from its own remaining deck, excluding all original cards.
+  Wins appear below cards in bold yellow; no win appears in bold white.
+
+  feature on|off switches bonuses between rounds. ON requires five base
+  coins per hand. Ultimate X and Hot Roll add five coins (10 total);
+  Super Times Pay adds one (6 total). Fees do not increase base payouts.
+  Ultimate X multipliers belong to the MACHINE: the next player inherits
+  them at the same game, payout tier, denomination and hand count. Feature
+  OFF can collect them but earns no new ones. Other bonuses have no carryover.
+
+  Payouts are total coins including stake, not profit. Multiply by denomination
+  for credits. Natural royals pay 250/500/750/1000 coins for 1-4 base coins,
+  or 4000 at five. Only the highest-paying category wins on each line.
+  look redisplays your hand; rules opens the cabinet guide; table rules shows
+  the pay table. stop leaves between hands. Disconnect finishes current holds.
+  If payment fails, draw retries the SAME final hands, never a fresh draw.
diff --git a/data/rooms/casino/6100.yaml b/data/rooms/casino/6100.yaml
index 6e77bc6..cf85c90 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, one salon each, going east. Each salon keeps its own house
+    baccarat, roulette, craps, slots, then video 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/6118.yaml b/data/rooms/casino/6118.yaml
index 5ec251b..ec06b43 100644
--- a/data/rooms/casino/6118.yaml
+++ b/data/rooms/casino/6118.yaml
@@ -4,6 +4,8 @@ description: A wall of chiming reels opens the machine gallery; limits are 1–2
 exits:
   west:
     room: 6185
+  east:
+    room: 6192
   north:
     room: 6120
   south:
diff --git a/data/rooms/casino/6192.yaml b/data/rooms/casino/6192.yaml
new file mode 100644
index 0000000..76635eb
--- /dev/null
+++ b/data/rooms/casino/6192.yaml
@@ -0,0 +1,40 @@
+name: Video Poker Lounge
+description: Five single-seat poker cabinets glow blue beneath yellow pay-table borders. Each offers a choice of poker games; the selected coin column shines red. Classic poker, two Ultimate X editions, Super Times Pay and Hot Roll stand side by side.
+exits:
+  west:
+    room: 6118
+casino_tables:
+- id: poker
+  game: video_poker
+  max_players: 1
+  video_poker:
+    cabinet: classic
+    payout: full
+- id: ultimate_x_single
+  game: video_poker
+  max_players: 1
+  video_poker:
+    cabinet: ultimate_x_single
+    payout: full
+- id: ultimate_x_multi
+  game: video_poker
+  max_players: 1
+  video_poker:
+    cabinet: ultimate_x_multi
+    payout: full
+- id: super_times_pay
+  game: video_poker
+  max_players: 1
+  video_poker:
+    cabinet: super_times_pay
+    payout: full
+- id: hot_roll
+  game: video_poker
+  max_players: 1
+  video_poker:
+    cabinet: hot_roll
+    payout: full
+objects:
+- name: poker plaque
+  description: 'Use play to list cabinets, then play <id>. game lists the games inside a cabinet; game jacks selects Jacks or Better. payout low|normal|full sets its pay quality across games. denom 1|10|50 sets credits per coin. bet max loads five coins; deal pays and deals. 531 toggles holds 1, 3 and 5; draw or d finishes. Ultimate X multipliers stay on the machine for the next player. rules explains your cabinet; paytable shows exact payouts.'
+  inroom_description: A brass poker plaque explains the five cabinets.