阅读本教程之前,请确保添加了物品,我们等下会要用到。
到目前为止,我们的物品可以通过创造模式菜单或者命令获得。要让它能够在生存模式获得到,我们需要为物品添加合成配方。
在 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 的配方页面。
配方也可以在运行时动态生成,更多信息可参考动态配方生成教程。