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/items.md | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

(limited to 'building_guide/items.md')

diff --git a/building_guide/items.md b/building_guide/items.md
index 52bfa7d..658acb9 100644
--- a/building_guide/items.md
+++ b/building_guide/items.md
@@ -1,7 +1,11 @@
 ## Items
 
+**The filename is the ID.** An item is looked up by its filename stem
+(`bronze_pickaxe.yaml` → `bronze_pickaxe`); the loader derives `ItemDef.ID` from it. Do not
+put an `id:` field in the file — it is ignored. Anything that references this item (drop
+tables, craft `consume`, room `item_spawns`) uses that filename.
+
 ```yaml
-id: bronze_pickaxe
 name: bronze pickaxe
 color: "178"                   # xterm-256 color index (0-255)
 aliases: ["pick", "pickaxe"]
@@ -85,7 +89,6 @@ Standard tiers: bronze/iron (none), steel (5), black (10), mithril (20), adamant
 Arrows and bolts use `ranged_strength` for damage. Accuracy comes from the bow:
 
 ```yaml
-id: iron_arrow
 name: iron arrow
 stackable: true
 equip_slot: ammo
@@ -107,7 +110,6 @@ In ANSI mode, extended colors (16-255) automatically downgrade to the nearest AN
 
 Key item (quest token, not equippable):
 ```yaml
-id: pass_stub
 name: pass stub
 description: "A crumpled slip of paper stamped with the guard's seal."
 value: 0
@@ -119,7 +121,6 @@ stackable: false
 ## Firemaking
 
 ```yaml
-id: logs
 name: logs
 fire_level: 1         # firemaking level required
 fire_xp: 40           # XP for burning/stoking
@@ -129,7 +130,6 @@ burn_ticks: 24        # how long the fire burns
 ## Food / Healing
 
 ```yaml
-id: bread
 name: bread
 color: "222"
 description: "A fresh loaf of bread, still warm from the oven."
@@ -143,7 +143,6 @@ eat_message: "You eat the bread. Warm and satisfying."
 Define what items combine to make this item. Used by the `use` command. Combinations run through the production system — players are prompted "How many?" and the action loops with a timer.
 
 ```yaml
-id: bread_dough
 name: bread dough
 color: "222"
 ticks: 2
-- 
cgit v1.2.3