首页
/ Create Mod 1.21.1版本中自定义配方加载问题解析

Create Mod 1.21.1版本中自定义配方加载问题解析

2025-06-25 06:40:23作者:侯霆垣

问题背景

在Create Mod的1.21.1版本(基于NeoForge)中,开发者发现通过数据包添加的自定义配方存在加载异常现象。具体表现为:标准原版配方可以正常加载,但使用Create特殊工艺系统(如压印、混合等)的配方无法被游戏识别。

技术分析

配方格式变更

从Create 6.0.1版本开始,配方JSON结构中的results字段语法发生了重大变更。新版本要求:

  1. 必须使用对象数组形式声明产出物
  2. 每个产出物需要明确指定数量和物品标识
  3. 不再支持旧版的简化语法格式

新旧语法对比

旧版错误语法示例

"results": [
  "minecraft:stone",
  "create:andesite_alloy"
]

新版正确语法

"results": [
  {
    "item": "minecraft:stone",
    "count": 1
  },
  {
    "item": "create:andesite_alloy",
    "count": 1
  }
]

解决方案

开发者需要检查所有自定义配方文件,确保:

  1. 每个配方中的results字段都采用对象数组结构
  2. 每个产出物都包含完整的itemcount属性
  3. 对于默认数量为1的物品仍需显式声明count值

兼容性说明

该语法变更仅影响:

  • NeoForge平台的1.21.1版本
  • Create 6.0.1及以上版本 Forge平台的1.20.1版本仍兼容旧语法

最佳实践建议

  1. 使用Create提供的示例配方作为模板
  2. 开发时启用游戏日志调试模式,可实时检测配方加载错误
  3. 对于复杂配方,建议先用JEI等模组验证配方有效性
  4. 跨版本迁移配方时注意检查语法差异

底层原理

该变更源于Create对配方系统的重构,新语法:

  • 更好地支持NBT标签等扩展属性
  • 提供更精确的数量控制
  • 为未来多产出物配方预留扩展空间
登录后查看全文
热门项目推荐
相关项目推荐