feat: casino framework and basic slot machine

1 files changed, 33 insertions, 0 deletions

diff --git a/building_guide/rooms.md b/building_guide/rooms.md
index 602e449..7641c75 100644
--- a/building_guide/rooms.md
+++ b/building_guide/rooms.md
@@ -218,6 +218,39 @@ Mobs stop wandering while in combat. Dead mobs respawn at their home room.
 
 ---
 
+### Casino Tables
+
+Rooms may host one or more casino tables. Players join by typing `play <game>`;
+the table ID is an internal room-local identifier and does not need to be typed.
+
+```yaml
+casino_tables:
+  - id: slots
+    game: slots
+    max_players: 8
+    betting_ticks: 20
+    min_bet: 1
+    max_bet: 1000
+```
+
+`max_players`, `betting_ticks`, `min_bet`, and `max_bet` use defaults when omitted.
+Game-specific rule configuration will be added alongside the table definition as
+each game is implemented.
+
+Single-player machines use `casino_machines` and are separate from multiplayer
+tables:
+
+```yaml
+casino_machines:
+  - id: huff_puff_01
+    game: slots
+    variant: huff_and_even_more_puff
+    min_bet: 1
+    max_bet: 1000
+    spin_ticks: 1
+    payout: 0.97
+```
+
 ### Objects — interactive fixtures
 
 Simple placement: