feat: new type of non-violent 'combat': work

1 files changed, 20 insertions, 0 deletions

diff --git a/building_guide/wandering_mobs.md b/building_guide/wandering_mobs.md
new file mode 100644
index 0000000..8d49ed9
--- /dev/null
+++ b/building_guide/wandering_mobs.md
@@ -0,0 +1,20 @@
+## Wandering Mobs
+
+Mob wandering is configured per-instance in the room YAML, not on the mob definition:
+```yaml
+# In a room:
+mobs:
+  - id: man
+    wander_interval: 10       # attempt to wander every 10 ticks
+  - id: man
+    wander_interval: 15
+    wander_rooms: [5, 6, 7]   # optional — restrict which rooms via exits
+```
+
+Mobs wander through legal (unconditioned) room exits. When the wander interval expires,
+the mob picks a random exit with no conditions and moves through it. If `wander_rooms`
+is set, only exits leading to those room IDs are legal. Mobs without `wander_interval`
+never wander. Mobs stop wandering while in combat. Dead mobs respawn at their home room.
+
+---
+