From 2725e2927a1595c7b100d942d1f14146252adeb7 Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Thu, 25 Jun 2026 04:46:40 -0400
Subject: feat: who, global chat, removed redundant YAML IDs

---
 building_guide/rooms.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

(limited to 'building_guide/rooms.md')

diff --git a/building_guide/rooms.md b/building_guide/rooms.md
index 735a6b4..e1408c5 100644
--- a/building_guide/rooms.md
+++ b/building_guide/rooms.md
@@ -1,8 +1,12 @@
 ## Rooms
 
+**The filename is the ID.** A room's numeric filename is its ID (`1.yaml` → room `1`); the
+loader derives it from the filename. Do not put an `id:` field in the file — it is ignored.
+Exits and other rooms reference a room by that number. (A nested `- id:` under `objects:` or
+`mobs:` is a *reference* to an object/mob by its filename, and is still required.)
+
 Minimal room:
 ```yaml
-id: 1
 name: "Town Square"
 description: "Cobblestone paths lead in all directions. A fountain gurgles peacefully."
 exits:
@@ -186,7 +190,6 @@ A room can reference a shared hazard by ID. The hazard rolls an attack against
 everyone in the room every few ticks using the combat formulas (see `hazards.md`).
 
 ```yaml
-id: 99999181
 name: "Exposed Solar Array"
 hazard: solar_radiation        # ID of a data/hazards/<id>.yaml definition
 exits:
-- 
cgit v1.2.3