feat: pachinko slots randomized, 9th slot removed, RTP set to 100% if played perfectly

5 files changed, 69 insertions, 3 deletions

diff --git a/data/help/casino.yaml b/data/help/casino.yaml
index fc7d85f..fe81bad 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: [big6, roulette, racetrack, blackjack, baccarat, craps, slots, video poker, pai gow poker, plinko, cash hunt, predictions, crypto]
+related: [big6, roulette, racetrack, blackjack, baccarat, craps, slots, video poker, pai gow poker, plinko, pachinko, cash hunt, predictions, crypto]
 description: |
   Casino quick guide
 
@@ -53,6 +53,7 @@ description: |
   help craps         Multiplayer dice, free odds, Fire and ATS bets.
   help slots         Matching symbols, ways and free spins.
   help plinko        Animated pyramid, four risk levels, up to ten balls.
+  help pachinko      Rectangle of pins; populated board; pick a top slot; DOUBLE chains prizes.
   help cash hunt     Reveal 100 prizes, mix their positions, pick one square.
   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.
diff --git a/data/help/pachinko.yaml b/data/help/pachinko.yaml
new file mode 100644
index 0000000..9147038
--- /dev/null
+++ b/data/help/pachinko.yaml
@@ -0,0 +1,53 @@
+name: pachinko
+aliases: [pachinko, pachinko machine]
+category: Interaction
+related: [casino, plinko]
+description: |
+  PACHINKO — a rectangle of pins. Pick your drop.
+
+  play pachinko              Take the single seat.
+  bet 10                     Commit 10 credits and reveal the board.
+  5 / drop 5                 Choose top slot 5 and drop the ball.
+  bet / rebet                Repeat your last wager and deal a new board.
+  table                      Show a blank board and the pay table.
+  stop                       Leave once no ball is in flight.
+
+  Every bet deals a fresh board of eight pockets and shows it before you
+  choose. Seven pockets are filler prizes drawn from 0.1x to 1.5x, mostly
+  0.5x and below, so the board is always busy. The eighth is a guaranteed
+  premium above 1.5x: usually 1.7x or 2x, occasionally 5x or 10x, and
+  about one board in 900 carries the 100x jackpot. Multipliers at or above
+  2x are whole numbers; below 2x they move in 0.1x steps. A DOUBLE appears
+  on about one board in twenty.
+
+  Filler prizes always return something, so a board is never a wall of
+  zeroes. Small fractions (0.1x, 0.5x) are the common texture; the
+  guaranteed premium is the reason to aim carefully.
+
+  Eight numbered top slots crown the board. A drop is 20 fair 50:50
+  bounces; the side walls reflect the ball, so the distribution is widest
+  in the middle and piles up against the walls. Because you see the board
+  first, the best slot moves from board to board. The pins stagger from
+  row to row, so even a ball that holds its lane visibly weaves between
+  them.
+
+  DOUBLE doubles EVERY prize on the board and drops the ball again for
+  free from any slot. The DOUBLE space stays where it is, so the doubling
+  can chain without limit: 2x becomes 4x, 8x, 16x... for as long as you
+  keep landing on it. The board grows hotter and brighter with each hit.
+
+  Multipliers INCLUDE your stake: 0.1x returns a tenth, 0.5x returns half,
+  2x returns double, and the 100x jackpot returns one hundred times
+  (before any DOUBLE).
+
+  Return is measured for a player who always chooses the best top slot:
+  exactly 100% — the house makes its money on slot choice, not on the
+  board. Dropping from a uniformly random slot returns about 80%. The table
+  command shows a blank board and the pay table; a House Edge instrument
+  reveals the exact odds. Fractional credits round without bias so the
+  average holds even for one-credit bets.
+
+  You cannot leave or re-bet mid-board. Shutdown refunds a committed
+  board; disconnecting forfeits an unfinished drop. A payout that cannot
+  be persisted keeps its stake pending for recovery rather than claiming
+  a paid win. Returns that would overflow the economy are capped.
diff --git a/data/help/plinko.yaml b/data/help/plinko.yaml
index 486a87b..a55acfd 100644
--- a/data/help/plinko.yaml
+++ b/data/help/plinko.yaml
@@ -1,7 +1,7 @@
 name: plinko
 aliases: [difficulty, balls]
 category: Interaction
-related: [casino]
+related: [casino, pachinko, cash hunt]
 description: |
   PLINKO — let it rain!
 
diff --git a/data/rooms/casino/6201.yaml b/data/rooms/casino/6201.yaml
index 9708f89..c1984d8 100644
--- a/data/rooms/casino/6201.yaml
+++ b/data/rooms/casino/6201.yaml
@@ -1,8 +1,10 @@
 name: The Kaleidoscope Vault
-description: One hundred jewel-lit shutters cover a wall of polished midnight glass. Behind each waits a prize, from an empty pocket to a fortune bright enough to light the entire casino. When the vault shuffles, ribbons of violet and gold sweep across the sealed squares. A small plaque reads, "One choice. Your fortune." The Crimson Rain Plinko Salon lies south.
+description: One hundred jewel-lit shutters cover a wall of polished midnight glass. Behind each waits a prize, from an empty pocket to a fortune bright enough to light the entire casino. When the vault shuffles, ribbons of violet and gold sweep across the sealed squares. A small plaque reads, "One choice. Your fortune." A tall Pachinko gallery rises to the north; the Crimson Rain Plinko Salon lies south.
 exits:
   south:
     room: 6200
+  north:
+    room: 6202
 casino_tables:
   - id: cash_hunt
     game: cash_hunt
diff --git a/data/rooms/casino/6202.yaml b/data/rooms/casino/6202.yaml
new file mode 100644
index 0000000..0ae636b
--- /dev/null
+++ b/data/rooms/casino/6202.yaml
@@ -0,0 +1,10 @@
+name: Fallen Star Pachinko Gallery
+description: A broad cabinet of polished obsidian frames a tall rectangle of silver pins. Numbered brass slots crown the top, a golden DOUBLE burns at the base, and jewel-bright prize lamps ring the pockets. Balls rain down in ribbons of light, bouncing pin to pin. The Kaleidoscope Vault glitters to the south.
+exits:
+  south:
+    room: 6201
+casino_tables:
+  - id: pachinko
+    game: pachinko
+    min_bet: 1
+    max_bet: 10000