Crafting Recipe

Export

Create a Crafting Recipe to describe the ingredients and expected output that a Crafting Processor can use. For a simple workflow, use exact Item Definitions as ingredients and produce one Health Potion; use broader Category or Item-specific inputs only when the design requires them.

Before you begin

Confirm that:

  • The intended Inventory System Database is selected in the Main Manager.
  • A concrete Consumable Recipes Crafting Category exists, is not Abstract, and uses the built-in base Crafting Recipe type.
  • Health Potion exists as an Item Definition.
  • The database contains the ingredient Item Definitions used by the project. The example below calls them Herb and Water; substitute existing definitions if the project uses different names.
  • The player Inventory, Crafter, and Crafting Menu will be available for runtime verification.

Create the Health Potion recipe

  1. Open Tools > Opsive > Ultimate Inventory System > Main Manager.
  2. In Setup, confirm that the intended Inventory System Database is selected.
  3. Open Crafting Recipes.
  4. Enter Brew Health Potion beside Add and create it. A new recipe initially uses the Uncategorized Crafting Category.
  5. In Properties, set Category to Consumable Recipes.
  6. Open Ingredients, add the Herb Item Definition with an amount of 2, and add the Water Item Definition with an amount of 1.
  7. Open Outputs and add 1 Health Potion.
  8. Review the visual recipe summary beneath the definition controls and confirm that it shows 2 Herb + 1 Water -> 1 Health Potion.

The Crafting Recipe editor showing the recipe list, selected recipe properties, ingredient and output controls, visual summary, and relationships.

Choose recipe properties

Property Decision Standard example
Name Use a unique name that describes the result or player action. The Scriptable Object filename follows it. Brew Health Potion
Category Choose the concrete Crafting Category that supplies the recipe type and grouping. Consumable Recipes
Editor Icon Assign an editor-only visual when the recipe list needs one. A Health Potion or crafting icon

Changing Category converts the recipe to the new category’s Recipe Type. Fields from the previous type can be removed when they do not exist on the new type, so choose the category before entering custom recipe data.

Choose the ingredient scope

The base Recipe Type accepts Item Categories, Item Definitions, and Items as ingredients:

Ingredient kind Use it when Effect
Item Category Any Item from a category should satisfy the requirement. A broad material category can allow several definitions.
Item Definition The recipe needs a specific Item type but any runtime copy is acceptable. Any runtime Herb Item can satisfy the 2-Herb requirement.
Item The recipe needs specific runtime Item data. A processor can require a particular Item or attribute state.

Use Item Definitions for the standard Health Potion recipe. They make the requirement predictable without depending on one runtime instance. Use a Category only when substitutions are intentional.

A recipe is a guideline for its Crafting Processor. If crafting depends on a runtime attribute, such as quality or Durability, confirm that the selected Recipe Type and processor evaluate that attribute rather than assuming the data alone enforces the rule.

Configure the recipe tabs

Ingredients

Add each required Item Category, Item Definition, or Item with its amount. For the example, enter 2 Herb and 1 Water as Item Definition amounts.

Outputs

Add the Item amounts produced by a successful craft. The base workflow usually produces one Item type, but the output supports a list. Set Health Potion to an amount of 1.

Other and custom tabs

The Other tab displays serialized fields supplied by a custom Recipe Type. A custom type can also add tabs, such as Currency requirements. Keep custom fields empty only when the selected processor does not require them.

The visual summary combines the tabs into one result view. Use it as the final editor check instead of reviewing each amount in isolation.

Find and duplicate recipes

Use c:<CraftingCategoryName> in the search field to find recipes that inherit from a named Crafting Category.

Right-click a recipe and choose Duplicate when a new recipe uses the same Category and similar inputs. Rename the copy and review every ingredient, output, custom field, and Editor Icon before using it.

The Relationships section shows the Crafting Categories related to the recipe. Confirm that Consumable Recipes appears and that the category’s Direct Crafting Recipes list contains Brew Health Potion.

Connect the recipe to the Crafter and Crafting Menu

Add Consumable Recipes to the Crafter’s Crafting Categories list. The Crafter combines its recipe list with a Crafting Processor, which decides whether the selected Inventory Items satisfy the recipe and performs the craft.

The Crafting Menu should reference the player’s Inventory and that Crafter. Its Crafting Recipe Grid lists the available recipes, while the Recipe Panel displays the selected recipe’s ingredients and output.

Editor checkpoints

Before entering Play Mode, confirm that:

  • Brew Health Potion uses Consumable Recipes rather than Uncategorized.
  • Its Recipe Type is the base type expected by the Crafter’s processor.
  • Ingredients contains exactly 2 Herb and 1 Water as Item Definition amounts, or the project’s documented substitutes.
  • Outputs contains exactly 1 Health Potion.
  • The visual summary matches the intended input-to-output relationship.
  • Consumable Recipes lists Brew Health Potion under Direct Crafting Recipes.
  • The Crafter includes Consumable Recipes and the Crafting Menu references that Crafter and the player Inventory.

Verify with the Crafter and Crafting Menu

  1. Enter Play Mode and open the Crafting Menu.
  2. Confirm that Brew Health Potion appears in the Crafting Recipe Grid.
  3. Select it and confirm that the Recipe Panel shows 2 Herb, 1 Water, and 1 Health Potion output.
  4. With one ingredient missing, try to craft and confirm that no inputs are removed and no output is added.
  5. Add the required Items to the player Inventory and craft a quantity of 1.
  6. Confirm that exactly 2 Herb and 1 Water are removed and 1 Health Potion is added.
  7. If the Quantity Picker is enabled, craft a larger valid quantity and confirm that every input and output amount scales consistently.

Troubleshooting

  • Consumable Recipes cannot be selected: Check whether the Crafting Category is Abstract and whether the Main Manager uses the same database.
  • Recipe fields disappear after changing Category: The new category uses a different Recipe Type. Restore the intended Category or re-enter only fields supported by the new type.
  • The recipe accepts the wrong Items: Check whether the ingredient uses an Item Category, Item Definition, or Item. Narrow the scope when substitutions are not intended.
  • An attribute-specific requirement is ignored: Confirm that the Recipe Type stores the required data and that the Crafting Processor explicitly evaluates it.
  • The visual summary shows the wrong amount: Correct the value in Ingredients or Outputs, then verify the summary before retesting.
  • The recipe is absent from the Crafting Menu: Check the Crafter’s Crafting Categories and Miscellaneous Recipes, then confirm that the menu references that Crafter.
  • Crafting succeeds but the Inventory does not change as expected: Check the processor, recipe output, destination Inventory restrictions, and any external ingredient-removal option on the Crafter.
  • A duplicate retains old data: Review the copied Category, ingredients, outputs, custom tabs, and Editor Icon before publishing it.