Differences

This shows you the differences between two versions of the page.

--- tutorial:recipes [2019/07/26 14:12] – created fudge
+++ tutorial:recipes [2025/04/01 08:18] (current) – [More on the recipe type] update link solidblock
@@ Line 1: / Line 1: @@
 ====== Crafting recipes ======
 ===== Adding a basic crafting recipe =====
-Make sure you [tutorial:items|added an item] before reading this tutorial, we will be using it.
+Make sure you [[tutorial:items|added an item]] before reading this tutorial, we will be using it.
 So far, our item is obtainable through the creative menu or commands.
 To make it available to survival players, we'll add a crafting recipe for the item.
-Create a file named ''fabric_item.json'' under ''resources/data/tutorial/recipes/'' (replace tutorial with your mod id if appropriate).
+Create a file named ''custom_item.json'' under ''resources/data/tutorial/**recipe**/'' (since 1.21) or ''resources/data/tutorial/**recipes**/'' (below 1.21) (replace "''tutorial''" with your namespace if appropriate).
-Here's an example recipe for the ''fabric_item'' we made:
-<code javascript resources/data/tutorial/recipes/fabric_item.json>
+Recipe files are conventionally named after their output, but they can have any name. Here's an example recipe for the ''custom_item'' we made (remember the path is //"recipes"// before 1.21 and //"recipe"// since 1.21, and in the ''%%"result"%%'' field, replace ''%%"id"%%'' with ''%%"item"%%'' for versions before 1.21):
+<code javascript resources/data/tutorial/recipe/custom_item.json>
 {
   "type": "minecraft:crafting_shaped",
@@ Line 25: / Line 27: @@
   },
   "result": {
-    "item": "tutorial:fabric_item",
+    "id": "tutorial:custom_item",
     "count": 4
   }
@@ Line 32: / Line 34: @@
 Breakdown of the recipe:
   *  **type**: This is a shaped crafting recipe.
-  *  **result**: This is a crafting recipe for 4 ''tutorial:fabric_item''.
+  *  **result**: This is a crafting recipe for 4 ''tutorial:custom_item''. The ''count'' field is optional. If you don't specify a ''count'', it will default to 1.
-  *  **pattern**: A pattern that represents the crafting recipe. Each letter represents one item. An empty space means that no item is required in that slot. What each letter represents is defined in **keys**.
+  *  **pattern**: A pattern that represents the crafting recipe. Each letter represents one item. An empty space means that no item is required in that slot. What each letter represents is defined in **key**.
-  *  **key**:  What each letter in the pattern represents. ''W'' represents any item with the ''minecraft:logs'' tag (all logs). ''R'' represent the redstone item specificly.  For more information about tags see [[https://minecraft.gamepedia.com/Tag|here]]
+  *  **key**:  What each letter in the pattern represents. ''W'' represents any item with the ''minecraft:logs'' tag (all logs). ''R'' represent the redstone item specificly.  For more information about tags see [[https://minecraft.gamepedia.com/Tag|Tag page in Minecraft Wiki]].
+  * **category**: The category of the item to display in the recipe book.
 In total, the crafting recipe would look like this:
-^           Recipe for 4 fabric_item           ^^^
+^           Recipe for 4 custom_item           ^^^
 |Any Log|Any Log|Any Log|
 |Any Log|Redstone|Nothing|
 |Any Log|Any Log|Any Log|
-For more information about the format of basic recipes, see [[https://minecraft.gamepedia.com/Recipe|here]].
-===== Adding a custom crafting recipe =====
+For more information about the format of basic recipes, see [[https://minecraft.gamepedia.com/Recipe|Recipe page in Minecraft Wiki]].
-The ''type'' value can be changed to support a custom recipe [more information needed].
+Recipes can also be generated dynamically on runtime, for more information see [[dynamic_recipe_generation|Dynamic recipe generation tutorial]].
+===== More on the recipe type =====
+The ''type'' value can be changed so it can be used in the corresponding crafting block (stone cutter, blast furnace, smiting table, ...), see all types and values [[https://minecraft.wiki/Recipe|Recipe page in Minecraft Wiki]].
+  * [[recipe_types_introduction|Create your own recipe type]]
+  * [[datagen_recipe|Generate recipes with data generator]]