阅读本教程之前,请确保添加了物品,我们等下会要用到。

到目前为止,我们的物品可以通过创造模式菜单或者命令获得。要让它能够在生存模式获得到,我们需要为物品添加合成配方。

在 resources/data/tutorial/recipe/(自从 1.21)或 resources/data/tutorial/recipes/(1.21 之前)目录下创建一个名为 custom_item.json 的文件(记得把“tutorial”替换为自己的命名空间)。

一般来说配方文件直接用其输出物品命名,但也可以是任何名称。这是我们制作 custom_item 的示例(记住路径在 1.21 之前是 “recipes”,从 1.21 开始是 “recipe”,以及在 1.21 之前的版本中,在 "result" 字段中将 "id" 替换为"item"):

resources/data/tutorial/recipe/custom_item.json

{

"type": "minecraft:crafting_shaped",

"pattern": [

"WWW",

"WR ",

"WWW"

],

"key": {

"W": {

"tag": "minecraft:logs"

},

"R": {

"item": "minecraft:redstone"

}

},

"result": {

"id": "tutorial:custom_item",

"count": 4

}

}

配方内容解析:

type:这是个有序合成配方。

result:这是合成4个 tutorial:custom_item 的配方。count 字段是可选的,如果不指定 count,则默认为 1。

pattern:代表合成配方的图案。每个字母代表一个物品。空格表示该槽位没有物品。每个字母代表的物品在 key 中定义。

key:每个字母代表的物品。W 代表带有 minecraft:logs 标签的物品(即所有原木)。R 代表红石。关于标签的更多信息,请参考 此处。

category:这个配方在解锁后在配方书中显示的分类。

总之,该合成配方应该是这样的:

4 个 custom_item 的合成配方

任何原木任何原木任何原木

任何原木红石空白

任何原木任何原木任何原木

关于基本配方格式的更多信息,参考Minecraft Wiki 的配方页面。

配方也可以在运行时动态生成,更多信息可参考动态配方生成教程。