aboutsummaryrefslogtreecommitdiff
path: root/building_guide/items.md
diff options
context:
space:
mode:
Diffstat (limited to 'building_guide/items.md')
-rw-r--r--building_guide/items.md60
1 files changed, 16 insertions, 44 deletions
diff --git a/building_guide/items.md b/building_guide/items.md
index e03622d..6280993 100644
--- a/building_guide/items.md
+++ b/building_guide/items.md
@@ -162,52 +162,24 @@ heal_value: 5 # positive = heal, negative = damage
eat_message: "You eat the bread. Warm and satisfying."
```
-## MadeFrom — Item Combinations
+## Item Combinations
-Define what items combine to make this item. Used by the `use` command. Combinations run through the production system — players are prompted "How many?" and the action loops with a timer.
+Item-on-item combinations use the `craft:` block (same as all other recipes). Define the
+output item with `type: ""` (or omit it) and the ingredients. See `recipes.md` for the full
+craft reference — byproducts, multi-item ingredient slots, message variables, and multi-step
+assembly.
-```yaml
-name: bread dough
-color: "DE"
-ticks: 2
-made_from:
- - items: [pot_of_flour]
- quantity: 1
- byproducts: [empty_pot]
- - items: [bucket_of_water, pitcher_of_water]
- quantity: 1
- byproducts: [empty_bucket, empty_pitcher]
-```
-
-Each entry is an ingredient slot. Multiple `items` means any of them works. The first matching item found in inventory is consumed.
-
-`ticks` controls how many game ticks each production cycle takes (default 2).
-
-### Byproducts
-
-`byproducts` is a list matching the `items` list by index. When `bucket_of_water` (items[0]) is consumed, `empty_bucket` (byproducts[0]) is returned to inventory. When `pitcher_of_water` (items[1]) is consumed, `empty_pitcher` (byproducts[1]) is returned instead.
-
-Use `""` for items that produce no byproduct:
-
-```yaml
-made_from:
- - items: [pot_of_flour, loose_flour]
- quantity: 1
- byproducts: [empty_pot, ""] # pot returns empty_pot, loose flour returns nothing
- - items: [bucket_of_water]
- quantity: 1
- byproducts: [empty_bucket]
-```
-
-Omit `byproducts` entirely if no items in that slot produce a byproduct:
+Quick example — filling a bucket:
```yaml
-made_from:
- - items: [pot_of_flour]
- quantity: 1
- byproducts: [empty_pot] # returns empty_pot
- - items: [salt]
- quantity: 1 # no byproducts field — salt is consumed entirely
+name: bucket of water
+craft:
+ ticks_per_cycle: 0
+ ingredients:
+ - items: [vial_of_water, jug_of_water]
+ quantity: 1
+ byproducts: [empty_vial, empty_jug]
+ - items: [empty_bucket]
+ quantity: 1
+ success_message: "You pour the %i1 into the %i2."
```
-
-See also `recipes.md` for station-based recipes.