aboutsummaryrefslogtreecommitdiff
path: root/data/help/use.yaml
blob: a6efafbbc599c8cc315a9b17e4c420a2ddef792c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
name: "use"
category: "General"
description: |
  Use an item on a target — the universal interaction command.

  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)

  The "use" command routes to different systems based on the target:

    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