From 79764732406d6484f67d3dec045483dcb5d08c28 Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Fri, 18 Sep 2026 20:03:13 -0400
Subject: feat: better card ascii art

---
 building_guide/rooms.md | 37 +++++++++++++++++++++++++------------
 1 file changed, 25 insertions(+), 12 deletions(-)

(limited to 'building_guide/rooms.md')

diff --git a/building_guide/rooms.md b/building_guide/rooms.md
index 3b9c120..c70b379 100644
--- a/building_guide/rooms.md
+++ b/building_guide/rooms.md
@@ -10,11 +10,18 @@ Minimal room:
 name: "Town Square"
 description: "Cobblestone paths lead in all directions. A fountain gurgles peacefully."
 exits:
-  north: 2
-  west: 7
-  east: 3
+  north:
+    room: 2
+  west:
+    room: 7
+  east:
+    room: 3
 ```
 
+Every exit is a mapping with a `room:` target. The scalar shorthand
+(`north: 2`) is **not** accepted by the loader: it fails strict YAML decoding
+and the room is reported as a load ERROR.
+
 ### Map color
 
 A room may set a `color` that tints its node on the map and the links connecting it:
@@ -53,9 +60,12 @@ Always passable, any direction:
 
 ```yaml
 exits:
-  north: 2
-  ne: 3
-  southeast: 4
+  north:
+    room: 2
+  ne:
+    room: 3
+  southeast:
+    room: 4
 ```
 
 #### Conditional exits
@@ -200,8 +210,8 @@ Simple placement (no wandering):
 
 ```yaml
 mobs:
-  - "newbie_trainer"
-  - "man"
+  - id: newbie_trainer
+  - id: man
 ```
 
 With wander config per-instance:
@@ -574,11 +584,12 @@ the room every few ticks using combat formulas.
 name: "Exposed Solar Array"
 hazard: solar_radiation        # ID of data/hazards/solar_radiation.yaml
 exits:
-  south: 99999180
+  south:
+    room: 99999180
 objects:
   - id: rock_outcrop           # safespot object shields players from the hazard
 mobs:
-  - solar_panel_frame          # task worksite (see mobs.md)
+  - id: solar_panel_frame      # task worksite (see mobs.md)
 ```
 
 - Players get a `[Y/n]` confirmation when walking from a safe room into a hazardous one
@@ -732,7 +743,8 @@ on_use:
 ```yaml
 name: "Hidden Passage"
 exits:
-  south: 2
+  south:
+    room: 2
   north:
     room: 8
     condition:
@@ -762,7 +774,8 @@ stackable: false
 ```yaml
 name: "Locked Storage"
 exits:
-  west: 2
+  west:
+    room: 2
   east:
     room: 6
     condition:
-- 
cgit v1.2.3