feat: recipe system, combining items, cooking skill

1 files changed, 25 insertions, 0 deletions

diff --git a/worldbuilding_guide/README.md b/worldbuilding_guide/README.md
new file mode 100644
index 0000000..8555e49
--- /dev/null
+++ b/worldbuilding_guide/README.md
@@ -0,0 +1,25 @@
+# World Building Guide
+
+Third Collapse is data-driven. Everything — rooms, items, mobs, objects, behaviors, drop tables, and recipes — is defined in YAML files under `data/`. No code changes needed to build a world.
+
+## Files
+
+| Document | Covers |
+|----------|--------|
+| [Rooms](rooms.md) | Room definitions, exits (simple and conditional), spawns, placed objects and mobs, on_enter scripts |
+| [Items](items.md) | Item definitions, stats, equip slots, weapon types, tool types, firemaking, food/healing |
+| [Mobs](mobs.md) | Mob definitions, combat stats, drops, behavior, idle descriptions |
+| [Objects](objects.md) | Interactive objects, behaviors, hidden objects, in-room descriptions |
+| [Behaviors](behaviors.md) | Gather, use, talk, toggle behaviors with full YAML reference |
+| [Recipes](recipes.md) | Recipe system for cooking, crafting, smithing — station and item-on-item |
+| [Conditions](conditions.md) | All condition types: flag, player_flag, has_item, all_of, any_of, not |
+| [Drop Tables](drops.md) | Shared weighted drop tables for mob loot and search tables |
+| [State](state.md) | World flags vs player flags — global vs per-character state |
+| [Doors](doors.md) | Door examples with world flags and player flags |
+| [Quests](quests.md) | Complete multi-room quest example with talk behaviors |
+| [Wandering Objects](wandering_objects.md) | Objects that teleport between rooms on a timer |
+| [Wandering Mobs](wandering_mobs.md) | Mobs that wander through legal exits |
+| [Toggles](toggles.md) | Player toggle options (tiny_map, xp_drops, automap, etc.) |
+| [Search](search.md) | The search command and searchable items |
+| [Hidden Objects](hidden_objects.md) | Hidden interactive objects |
+| [Tips](tips.md) | Practical tips for building a world |