1 files changed, 79 insertions, 4 deletions
diff --git a/worldbuilding_guide/items.md b/worldbuilding_guide/items.md
index 0a4592b..a1ca8c1 100644
--- a/worldbuilding_guide/items.md
+++ b/worldbuilding_guide/items.md
@@ -9,13 +9,88 @@ description: "A sturdy bronze pickaxe."
 value: 10
 stackable: false
 equip_slot: main_hand        # optional — where it equips
-weapon_type: melee            # optional — melee or ranged
-stats:                        # optional — combat bonuses
-  attack_bonus: 2
-  strength_bonus: 1
+weapon_type: melee            # optional — melee, ranged, or science
+attack_type: stab             # stab/slash/crush/ranged/science — determines accuracy type
+stats:                        # optional — per-type combat bonuses
+  stab_attack: 4
+  slash_attack: -2
+  crush_attack: 2
+  strength_bonus: 3
 speed: 5                      # ticks between attacks
 tool_type: pickaxe            # used by gather behaviors that require "tool: pickaxe"
 tool_speed: 2                 # reduces gather wait time
+requirements:                 # optional — skill levels needed to equip
+  attack: 1
+```
+
+### Equipment Stats (ItemStats)
+
+Weapons have per-type **attack bonuses** — these determine accuracy based on the weapon's `attack_type`:
+
+| Field | Description |
+|---|---|
+| `stab_attack` | Accuracy bonus for stab attacks |
+| `slash_attack` | Accuracy bonus for slash attacks |
+| `crush_attack` | Accuracy bonus for crush attacks |
+| `science_attack` | Accuracy bonus for science attacks |
+| `ranged_attack` | Accuracy bonus for ranged attacks |
+
+Armor has per-type **defense bonuses** — the mob's `attack_type` determines which defense is used:
+
+| Field | Description |
+|---|---|
+| `stab_defense` | Defense vs stab attacks |
+| `slash_defense` | Defense vs slash attacks |
+| `crush_defense` | Defense vs crush attacks |
+| `science_defense` | Defense vs science attacks (negative on metal armor) |
+| `ranged_defense` | Defense vs ranged attacks |
+
+Other damage/utility bonuses:
+
+| Field | Description |
+|---|---|
+| `strength_bonus` | Melee max hit bonus |
+| `ranged_strength` | Ranged max hit bonus (on ammo) |
+| `science_damage` | Science max hit bonus |
+| `technology_bonus` | Reduces tech battery drain rate |
+
+### Attack Type
+
+Weapons should always set `attack_type`. Common mappings:
+
+| Category | attack_type |
+|---|---|
+| Swords | slash |
+| Daggers | stab |
+| Axes | slash |
+| Pickaxes | stab |
+| Bows | ranged |
+| Unarmed | crush (default) |
+
+### Equipment Requirements
+
+Higher-tier equipment requires skill levels to equip:
+
+```yaml
+requirements:
+  attack: 20      # melee weapons
+  defense: 20     # armor
+  ranged: 30      # ranged weapons/armor
+```
+
+Standard tiers: bronze/iron (none), steel (5), black (10), mithril (20), adamant (30), rune (40), dragon (60).
+
+### Ranged Ammo
+
+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
+stats:
+  ranged_strength: 10
 ```
 
 ### Color