Minecraft 1.12.2模组开发：如何用JSON文件自定义合成配方（附常见错误排查）

Minecraft 1.12.2模组开发：JSON配方配置实战指南与深度排错

在Minecraft模组开发的世界里，合成配方是连接创意与实现的关键桥梁。当你精心设计的方块或物品需要通过工作台合成时，JSON配置文件就是那把打开合成之门的钥匙。不同于基础教程的泛泛而谈，本文将带您深入JSON配方的每一个细节角落，从有序合成的精确布局到无序合成的灵活组合，再到那些让开发者夜不能寐的典型错误——我们不仅要学会正确书写，更要理解为什么这样写。

1. 合成配方基础：理解两种核心类型

Minecraft中的合成配方主要分为有序合成（crafting_shaped）和无序合成（crafting_shapeless）两种类型，它们对应着游戏内不同的合成逻辑和使用场景。

有序合成要求物品在工作台中按照特定图案排列，就像现实中的钥匙必须与锁芯精确匹配。这种合成方式常用于工具、装备等需要特定结构的物品。例如钻石镐的经典配方：

{
  "type": "minecraft:crafting_shaped",
  "pattern": [
    "DDD",
    " S ",
    " S "
  ],
  "key": {
    "D": { "item": "minecraft:diamond" },
    "S": { "item": "minecraft:stick" }
  },
  "result": {
    "item": "minecraft:diamond_pickaxe",
    "count": 1
  }
}

无序合成则更加灵活，只要材料齐全，无论在工作台中如何摆放都能成功。这种合成方式适合染料混合、食物制作等场景。例如制作南瓜派的配方：

{
  "type": "minecraft:crafting_shapeless",
  "ingredients": [
    { "item": "minecraft:pumpkin" },
    { "item": "minecraft:egg" },
    { "item": "minecraft:sugar" }
  ],
  "result": {
    "item": "minecraft:pumpkin_pie",
    "count": 1
  }
}

提示：选择合成类型时，考虑物品的现实逻辑——需要特定结构的选有序，材料混合即可的选无序。

2. JSON文件结构深度解析

2.1 有序合成的核心元素

一个完整的有序合成JSON包含四个关键部分：

1. type：固定为"minecraft:crafting_shaped"
2. pattern：定义3x3工作台的物品排列，每行最多3个字符
3. key：将pattern中的字符映射到具体物品
4. result：指