Lithium项目中的世界生成死锁问题分析与解决方案

问题背景

在Minecraft 1.21.1 Fabric环境中，当Repurposed Structures模组尝试生成包含骷髅马骑士的地下堡垒结构时，服务器出现了内部死锁现象。具体表现为区块停止加载、游戏逻辑停滞，但日志中未显示任何错误信息。通过线程转储分析发现，服务器线程在等待区块加载时被锁定。

技术分析

死锁触发机制

1. 结构生成流程：Repurposed Structures模组在生成地下堡垒时会创建骷髅马骑士实体，这些实体具有骑乘关系（骷髅骑在马上）。

2. 事件触发链：

   • 实体加载过程中触发了游戏事件（GameEvent）
   • 游戏事件被附近的幽匿感测体接收
   • 感测体尝试访问相邻区块（xz坐标57,19）
   • 此时主线程正在加载原始区块（xz坐标57,20）

3. 关键冲突点：

   • 主线程持有原始区块锁的同时，需要访问相邻区块
   • 事件处理线程尝试获取原始区块锁来完成事件处理
   • 形成典型的交叉锁死锁场景

与Lithium的关系

最初怀疑与Lithium的以下优化相关：

• 游戏事件调度优化（mixin.world.game_events.dispatch）
• 区块加载调度优化

但经过验证：

• 问题在完全禁用Lithium后仍然存在
• 根本原因是Minecraft原版代码的线程安全问题

解决方案

临时解决方案

对于使用Lithium的用户：

1. 检查lithium.properties配置文件
2. 确保mixin.world.game_events.dispatch选项保持禁用状态（默认即为禁用）

根本解决方案

1. 代码层面修复：

   • 避免在世界生成期间触发可能引起区块加载的游戏事件
   • 参考NeoForge的实现方式，通过标记"正在加载"状态来允许临时访问

2. 模组兼容建议：

   • 对于结构生成模组，应避免在区块加载阶段创建会立即触发事件的实体
   • 可以考虑延迟事件触发或使用特殊标记跳过初始事件

技术启示

1. 线程安全的重要性：在游戏开发中，特别是涉及世界生成和多线程处理的场景，需要特别注意锁的获取顺序。

2. 事件系统的复杂性：Minecraft的事件系统虽然强大，但在多线程环境下容易引发难以预料的问题。

3. 性能优化的边界：性能优化模组在提升效率的同时，可能暴露出原版代码中的潜在问题。

这个问题展示了Minecraft模组生态系统中，不同系统交互时可能产生的复杂问题。理解这些底层机制有助于开发者编写更健壮的模组代码。