aboutsummaryrefslogtreecommitdiff
path: root/building_guide/items.md
diff options
context:
space:
mode:
authorhistoria <[not public]>2026-06-25 04:46:40 -0400
committerhistoria <[not public]>2026-06-25 04:46:40 -0400
commit2725e2927a1595c7b100d942d1f14146252adeb7 (patch)
treee8bc2292634a2d686c751981ddb3097517cccc6a /building_guide/items.md
parent94a06fbbe682701ca4d4bd2a70cd74d8df29c932 (diff)
downloadthehouseoficarus-2725e2927a1595c7b100d942d1f14146252adeb7.tar.gz
feat: who, global chat, removed redundant YAML IDs
Diffstat (limited to 'building_guide/items.md')
-rw-r--r--building_guide/items.md11
1 files changed, 5 insertions, 6 deletions
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