Iris/Oculus & GeckoLib Compat — 在 Minecraft 中修复带光影动画的模组

Iris/Oculus & GeckoLib Compat — 在 Minecraft 中修复带光影动画的模组

Iris/Oculus & GeckoLib Compat（也称为 GeckoAnimFix）是一个用于 Minecraft 的小型客户端模组，它修复了一个特定的 bug：当光影包中启用实体阴影时，基于 GeckoLib 库构建的生物及其他实体的动画会停止播放。自定义生物会僵在同一个姿势——看起来就像世界中央的雕像。

bug 的来源

GeckoLib 库是制作更复杂 3D 模型和生物骨骼动画的常用工具。数十个拥有自定义生物的模组都在使用它：用于行走循环、呼吸、挥舞武器、攻击姿势等等。Minecraft 中实体的渲染实际上每帧会执行多次——分别用于主画面，以及分别用于构建阴影贴图。动画只应在其中一个渲染通道中更新。

当光影包添加实体阴影（Entity Shadows 选项）时，生物模型会为光影通道再次绘制。在旧版本的 GeckoLib 中，在这个额外通道上，模型的动画状态会出错——帧被卡住。没有光影或关闭实体阴影时，该 bug 不会出现。

模组究竟做了什么

GeckoAnimFix 对 GeckoLib 的行为做了一处小修改——使得生物的动画循环不会在由光影阴影激活的额外渲染通道上被重置。无论 Iris 或 Oculus 中启用了哪种光影，实体都会照常播放它们的动画。

该模组会自动工作——将 .jar 文件放入 mods/ 文件夹后，无需任何额外设置。不会出现任何命令、新方块或游戏内菜单：玩家只会注意到之前损坏的生物又恢复了正常活动。

如何安装

安装流程对相应的加载器而言是标准的——将 .jar 文件与 GeckoLib 库和光影模组（Iris 或 Oculus）一起放入 mods/ 文件夹。该模组不会在游戏中创建任何单独的服务文件。

有一个细节值得注意：模组版本必须与 Minecraft 和加载器的版本完全匹配。即使游戏版本号相同，为 Forge 编译的构建也无法在 Fabric 上运行，反之亦然。在 Modrinth 页面的文件列表中，会针对每个游戏版本分别标注特定的 .jar 支持哪个加载器。

结论

Iris/Oculus & GeckoLib Compat 解决了一项很狭窄的任务：当用户不想放弃光影包中的阴影时，它能让 Minecraft 中自定义生物的动画恢复生机。它最大的意义在于——在 GeckoLib 尚未包含自身修复的旧整合包 1.18.2–1.19.4 和早期 1.20 上游玩。其局限也很清楚：对于较新版本的 GeckoLib，该模组已属多余，甚至可能干扰带有复杂动画的模组。替代方案是直接将 GeckoLib 库本身更新到 4.x 或更新版本；这样就不再需要单独的修复，但需要整合包中其余模组都有兼容的版本。