1 files changed, 54 insertions, 0 deletions
diff --git a/worldbuilding_guide/mobs.md b/worldbuilding_guide/mobs.md
new file mode 100644
index 0000000..a025e86
--- /dev/null
+++ b/worldbuilding_guide/mobs.md
@@ -0,0 +1,54 @@
+## Mobs
+
+Basic combat mob:
+```yaml
+id: "man"
+name: "man"
+description: "A shabby-looking man."
+attack: 1
+strength: 1
+defense: 1
+hp: 7
+speed: 5
+aggressive: false
+respawn_ticks: 30
+drops:
+  remains: "bones"             # always dropped on death
+  loot:
+    - item_id: "credits"
+      weight: 98
+      quantity: 10
+    - item_id: "credits"
+      weight: 2
+      quantity: 150
+idle_descriptions:
+  - "scribbles something in a small notebook"
+  - "gazes skyward at the clouds"
+combat_descriptions:
+  - "is engaged in a fight to the death with %s"
+```
+
+Mob with a behavior — can be talked to, toggled, etc:
+```yaml
+id: "guard"
+name: "Guard"
+behavior: guard_talk          # links to data/behaviors/guard_talk.yaml
+unique: true                  # displays as "Guard" not "a guard"
+protected: true               # cannot be attacked
+attack: 5
+strength: 5
+defense: 5
+hp: 30
+speed: 5
+aggressive: false
+respawn_ticks: 60
+idle_descriptions:
+  - "scans the area with a watchful eye"
+  - "adjusts the grip on his weapon"
+```
+
+Note: `wander_rooms` and `wander_interval` are NOT set on the mob definition. Wander config
+is per-instance in the room YAML (see Rooms > Mobs section above).
+
+---
+