From 085e728d22a3369bd110b77409914cfbe9ebe611 Mon Sep 17 00:00:00 2001
From: historia <[not public]>
Date: Tue, 16 Jun 2026 04:17:43 -0400
Subject: feat: recipe system, combining items, cooking skill

---
 data/help/use.yaml | 32 ++++++++++++++++++++++++--------
 1 file changed, 24 insertions(+), 8 deletions(-)

(limited to 'data/help/use.yaml')

diff --git a/data/help/use.yaml b/data/help/use.yaml
index 41ceb34..a6efafb 100644
--- a/data/help/use.yaml
+++ b/data/help/use.yaml
@@ -1,13 +1,29 @@
 name: "use"
-category: "Skills"
+category: "General"
 description: |
-  Use a crafting station or interactive object.
+  Use an item on a target — the universal interaction command.
 
-  Usage: use <object>
+  Usage:
+    use <item>                    Use an item on a room object
+    use <item> on <target>        Use item on a specific target
+    use <item> with <item>        Combine two inventory items (shorthand)
 
-  Some objects can be used for crafting (furnaces, anvils, spinning wheels,
-  ranges, etc.). Using an object typically consumes items from your
-  inventory and produces something new, with an optional skill check.
+  The "use" command routes to different systems based on the target:
 
-  You need the required materials in your inventory. The action continues
-  until you run out of materials or inventory space.
+    Object target (room object)
+      If a recipe matches: opens the recipe menu for crafting/cooking
+      Otherwise: dispatches to the object's behavior (gather, talk, toggle)
+
+    Item target (inventory or ground)
+      If a recipe matches both items: combines them (e.g., flour + water)
+
+    Mob target
+      Future: give items to NPCs for quests
+
+  Examples:
+    use trout on fire           Cook trout on a campfire
+    use water on flour          Mix dough (opens recipe menu)
+    use bronze pickaxe on rock  Mine copper/tin rocks
+    use iron gate               Push/pull a gate (falls through to toggle)
+
+  See also: cook, recipe, gather, talk
-- 
cgit v1.2.3