1 files changed, 37 insertions, 0 deletions
diff --git a/worldbuilding_guide/objects.md b/worldbuilding_guide/objects.md
new file mode 100644
index 0000000..94aead7
--- /dev/null
+++ b/worldbuilding_guide/objects.md
@@ -0,0 +1,37 @@
+## Objects
+
+Object defined — links to a behavior:
+```yaml
+id: copper_rock
+name: copper rock
+behavior: mine_copper
+```
+
+Tree object:
+```yaml
+id: oak_tree
+name: oak tree
+behavior: chop_oak
+```
+
+Hidden object — doesn't appear in room's object list, only discoverable via description or experimentation:
+```yaml
+id: iron_gate
+name: iron gate
+behavior: iron_gate_toggle
+hidden: true
+props:
+  description: "A heavy iron gate set into the north wall."
+```
+
+Decorative object (no behavior):
+```yaml
+id: lumby_fountain
+name: town fountain
+behavior: ""
+props:
+  description: "Clear water sparkles in the sunlight."
+```
+
+---
+