1 files changed, 39 insertions, 0 deletions
diff --git a/building_guide/wandering_objects.md b/building_guide/wandering_objects.md
new file mode 100644
index 0000000..f1f91c5
--- /dev/null
+++ b/building_guide/wandering_objects.md
@@ -0,0 +1,39 @@
+## Wandering Objects
+
+Fishing spots that move between rooms:
+```yaml
+# data/objects/fishing_spot.yaml
+id: fishing_spot
+name: fishing spot
+gather:
+    skill: fishing
+    level: 1
+    xp: 10
+    base_wait: 4
+    tools:
+        - fishing_rod
+    bait: fishing_bait
+    success:
+        base: 0.30
+        per_level: 0.01
+        cap: 0.90
+    gather_message: "You cast your line into the water..."
+    drops:
+        - item_id: raw_trout
+          weight: 100
+          message: "You catch a raw trout!"
+```
+
+```yaml
+# In a room:
+objects:
+  - id: fishing_spot
+    wander_rooms: [7, 8, 9]
+    wander_interval: 12
+```
+
+Objects teleport between rooms in their `wander_rooms` list. Players gathering from a
+wandering object are silently interrupted when it moves.
+
+---
+