自定义配方
开发者可以在 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 配方配置示例。
