Fabric Wiki

User Tools

Site Tools

Trace: • Crafting recipes
tutorial:recipes

Differences

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

Link to this comparison view

Next revision		Previous revision
tutorial:recipes [2019/07/26 14:12] – created fudgetutorial:recipes [2026/03/01 23:38] (current) – Multiversion recipe examples cassiancc
Line 1: Line 1:
 ====== Crafting recipes ====== ====== Crafting recipes ======
 ===== Adding a basic crafting recipe ===== ===== 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. 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.   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. 
 + 
 +===== 1.21.2 and above ===== 
 + 
 +Recipes are stored in ''data/<namespace>/recipe''. 
 + 
 +<code javascript resources/data/tutorial/recipe/custom_item.json> 
 +{ 
 +  "type": "minecraft:crafting_shaped", 
 +  "pattern": [ 
 +    "WWW", 
 +    "WR ", 
 +    "WWW" 
 +  ], 
 +  "key": { 
 +    "W": "#minecraft:logs", 
 +    "R": "minecraft:redstone" 
 +  }, 
 +  "result": { 
 +    "id": "tutorial:custom_item", 
 +    "count": 4 
 +  } 
 +} 
 +</code> 
 + 
 +===== 1.21 through 1.21.1 ===== 
 + 
 +Recipes are stored in ''data/<namespace>/recipe''. 
 + 
 +<code javascript resources/data/tutorial/recipe/custom_item.json>
 { {
   "type": "minecraft:crafting_shaped",   "type": "minecraft:crafting_shaped",
Line 25: Line 54:
   },   },
   "result": {   "result": {
-    "item": "tutorial:fabric_item",+    "id": "tutorial:custom_item",
     "count": 4     "count": 4
   }   }
 } }
 </code> </code>
 +
 +===== 1.20 through 1.20.6 =====
 +
 +Recipes are stored in ''data/<namespace>/recipes''.
 +
 +<code javascript resources/data/tutorial/recipes/custom_item.json>
 +{
 +  "type": "minecraft:crafting_shaped",
 +  "pattern": [
 +    "WWW",
 +    "WR ",
 +    "WWW"
 +  ],
 +  "key": {
 +    "W": {
 +      "tag": "minecraft:logs"
 +    },
 +    "R": {
 +      "item": "minecraft:redstone"
 +    }
 +  },
 +  "result": {
 +    "item": "tutorial:custom_item",
 +    "count": 4
 +  }
 +}
 +</code>
 +
 +
 Breakdown of the recipe:   Breakdown of the recipe:  
   *  **type**: This is a shaped crafting 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: 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|Any Log|Any Log|
 |Any Log|Redstone|Nothing| |Any Log|Redstone|Nothing|
 |Any Log|Any Log|Any Log| |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]]
  
tutorial/recipes.1564150371.txt.gz · Last modified: 2019/07/26 14:12 by fudge