Baritone项目在NeoForge 1.21.1中的兼容性修复：解决与Elytra Slot的启动冲突

2025-05-30 07:19:45作者：戚魁泉Nursing

问题背景

在Minecraft 1.21.1版本的NeoForge环境中，当同时安装Baritone和Elytra Slot这两个模组时，游戏会在启动阶段崩溃。这是一个典型的模组间兼容性问题，涉及到核心游戏类的修改时机和初始化顺序的冲突。

技术分析

崩溃原因深度剖析

问题的根源在于Baritone对ItemStack类的mixin修改与Elytra Slot在游戏初始化阶段的交互产生了时序冲突。具体来说：

Elytra Slot触发能力注册：在RegisterCapabilitiesEvent事件期间，Elytra Slot需要获取物品的默认实例，调用了Item.getDefaultInstance()方法。
ItemStack初始化：该方法创建新的ItemStack实例时，触发了Baritone注入的mixin代码。
Baritone的mixin行为：Baritone通过MixinItemStack类修改了ItemStack的构造函数，在初始化时立即计算物品的哈希值。
过早的配置访问：哈希计算过程中，某些模组(如Construction Sticks)的配置值被访问，而此时这些配置尚未加载完成。

技术细节

Baritone的mixin在ItemStack类中注入了三个关键点：

构造函数返回时(onInit)
设置损伤值时(onItemDamageSet)
获取Baritone哈希值时(getBaritoneHash)

这些注入点都会调用recalculateHash()方法，该方法会触发ItemStack.getDamageValue()的调用链，最终可能导致其他模组尝试访问未初始化的配置。

解决方案设计

核心思路

通过引入"游戏就绪"标志位，延迟Baritone的哈希计算逻辑，直到游戏初始化完成。这需要：

在Baritone主类中添加静态标志位
修改mixin逻辑使其依赖该标志位
在适当的生命周期事件中设置标志位

具体实现

1. 添加游戏就绪标志

在Baritone主类中添加volatile静态布尔变量：

public static volatile boolean isGameReadyForBaritoneItemStackMixin = false;

volatile关键字确保多线程环境下的可见性，这对于模组加载环境尤为重要。

2. 修改MixinItemStack

对三个注入点都添加标志检查：

if (Baritone.isGameReadyForBaritoneItemStackMixin) {
    recalculateHash();
}

同时增强recalculateHash()的健壮性，添加异常处理：

private void recalculateHash() {
    try {
        baritoneHash = item == null ? -1 : item.hashCode() + getDamageValue();
    } catch (Exception e) {
        System.err.println("[Baritone] MixinItemStack: Exception during recalculateHash!");
        e.printStackTrace();
        baritoneHash = -99; // 错误哈希值
    }
}

3. 设置标志位的时机

选择在FMLCommonSetupEvent事件中设置标志位，这是NeoForge生命周期中相对靠后的事件，确保：

配置加载完成
能力注册已完成
其他模组的核心初始化已完成

实现方式：

private void onCommonSetup(final FMLCommonSetupEvent event) {
    event.enqueueWork(() -> {
        Baritone.isGameReadyForBaritoneItemStackMixin = true;
        System.out.println("[Baritone] CommonSetup: ItemStack mixin兼容性标志已启用");
    });
}