MinecraftForge 1.21版本中模型加载机制的演进与解决方案

背景概述

在MinecraftForge 1.21.3/1.21.4版本中，模型加载系统经历了重大重构。这次重构导致原有的ModelEvent.RegisterAdditional事件被移除，这给需要动态加载额外模型的模组开发者带来了挑战。本文将从技术角度解析这一变化的背景、影响以及Forge团队提供的解决方案。

核心问题分析

在旧版本中，开发者可以通过RegisterAdditional事件注册未被直接引用的模型资源（如.json模型文件）。这些模型虽然存在于资源包中，但如果没有被方块状态或物品模型显式引用，系统不会自动加载它们。

新版本中，Minecraft底层改为自动发现并预加载所有models/*.json文件，但这些未被引用的模型会在烘焙阶段被丢弃。这导致依赖动态模型加载的功能（如实体自定义渲染）无法正常工作。

技术解决方案

方案一：通过物品模型包装（无需Forge修改）

Forge团队建议开发者可以利用现有的物品模型系统作为替代方案：

1. 创建一个物品模型JSON文件，引用目标方块模型：

{
  "model": {
    "type": "minecraft:model",
    "model": "modid:blocks/custom_model"
  }
}

2. 在代码中通过物品模型系统加载：

ItemModel itemModel = modelManager.getItemModel(new ResourceLocation("modid:custom_item"));
if (itemModel instanceof BlockModelWrapper wrapper) {
    // 使用wrapper.model获取底层方块模型
}

这种方案的优点是无需等待Forge更新，开发者可以立即实现。缺点是模型需要通过物品系统间接加载。

方案二：新增BlockState定义注册（Forge PR#10206）

Forge团队正在开发更原生的解决方案，通过新增ModelEvent.RegisterModelStateDefinitions事件：

1. 注册自定义方块状态定义：

event.register(rl("custom_head"), 
    new StateDefinition.Builder<>(Blocks.AIR)
        .create(Block::defaultBlockState, BlockState::new)
);

2. 创建对应的方块状态和模型文件：

// blockstates/custom_head.json
{
  "variants": {
    "": { "model": "modid:blocks/custom_head" }
  }
}

3. 直接通过方块模型系统加载：

ModelResourceLocation mrl = new ModelResourceLocation(rl("custom_head"), "");
BakedModel model = modelManager.getModel(mrl);

最佳实践建议

1. 对于需要快速上线的模组，建议采用方案一的物品模型包装方案
2. 关注Forge官方更新，及时迁移到更原生的方块状态定义方案
3. 复杂模型建议配合Forge的数据生成系统使用，确保模型兼容性

技术展望

Forge团队表示未来可能会进一步优化模型加载系统，包括：

1. 提供更灵活的模型发现机制
2. 增强客户端数据生成能力
3. 改进模型缓存管理

开发者应持续关注Forge的更新日志，及时调整模型加载策略以适应引擎变化。

通过理解这些技术演进，模组开发者可以更好地在新版本中实现自定义模型功能，同时为未来的Minecraft版本升级做好准备。