Skip to content

自定义配方 ​

开发者可以在 addon 的 behavior 目录下新增 netease_recipes/ 文件夹,通过配置 JSON 文件来添加自定义配方。目前支持有序合成、无序合成、熔炉、酿造、锻造等多种配方类型。本文将逐一介绍各种配方的 JSON 格式与配置方法。

前置知识

阅读本文前,建议先了解 自定义物品 的基础概念,因为配方的输入与输出均依赖物品的 identifier。

概述 ​

自定义配方允许开发者为工作台、熔炉、酿造台、切石机、锻造台等工作站添加新的合成规则。所有配方 JSON 文件应放置在行为包的 netease_recipes/ 目录下,文件名不做特殊要求。

注意

配方的输出物品不能设置自定义 NBT 数据标签。

待补充:配方系统整体架构说明。

有序合成配方(shaped) ​

有序合成配方使用 minecraft:recipe_shaped 类型,代表工作台上的有序合成。通过 pattern 定义 2×2 或 3×3 的合成图案,使用 key 映射字符与物品的对应关系。

待补充:完整字段说明表格与更多示例。

无序合成配方(shapeless) ​

无序合成配方使用 minecraft:recipe_shapeless 类型,代表工作台上的无序合成。通过 ingredients 数组定义 1~9 个原料物品,原料的排列顺序不影响合成结果。

待补充:完整字段说明表格与更多示例。

熔炉配方(furnace) ​

熔炉配方使用 minecraft:recipe_furnace 类型,定义熔炉、高炉、烟熏炉、营火的烧炼配方。通过 input 和 output 分别指定输入材料和输出产物。

待补充:tags 可选值(furnace、blast_furnace、smoker、campfire)说明。

酿造配方(brewing) ​

酿造配方分为两种类型:

  • 混合酿造 minecraft:recipe_brewing_mix:将一种药水与额外物品酿造为另一种药水。
  • 换容酿造 minecraft:recipe_brewing_container:改变药水的容器类型(如普通瓶→喷溅瓶)。

注意

输出的药水物品无法与原来的药水堆叠在一起。

待补充:完整字段说明与酿造链示例。

锻造台配方 ​

锻造台配方分为两种类型:

  • 锻造转换 minecraft:recipe_smithing_transform:用于升级装备材质(如钻石→下界合金),保留原物品属性。
  • 锻造纹饰 minecraft:recipe_smithing_trim:用于为盔甲添加装饰纹饰。

待补充:template、base、addition 字段说明及物品标签要求。

配方标签(tags)说明 ​

tags 字段决定配方在哪个工作站生效,支持以下值:

标签对应工作站
crafting_table工作台
stonecutter切石机
cartography_table制图台
furnace熔炉
blast_furnace高炉
smoker烟熏炉
campfire营火
brewing_stand酿造台
smithing_table锻造台

待补充:各标签的使用限制说明。

使用标签代替物品(1.19.50+) ​

从 1.19.50 版本开始,可以在配方的 key 或 ingredients 中使用 tag 字段代替 item 字段,用标签表示一类物品,简化配方配置。例如使用 "minecraft:planks" 标签匹配所有木板。

待补充:支持的标签完整列表。

配方 JSON 路径 ​

所有自定义配方文件应放置在以下目录:

behavior_pack/
└── netease_recipes/
    ├── my_shaped_recipe.json
    ├── my_shapeless_recipe.json
    └── my_furnace_recipe.json

待补充:文件命名建议与多配方组织方式。

完整示例 ​

待补充:一个包含有序合成、无序合成、熔炉配方的完整 addon 配方配置示例。

下一步 ​