Iris/Oculus & GeckoLib Compat — мод для исправления анимаций с шейдерами в Minecraft

Iris/Oculus & GeckoLib Compat — мод для исправления анимаций с шейдерами в Minecraft

Iris/Oculus & GeckoLib Compat (также известный как GeckoAnimFix) — небольшой клиентский мод для Minecraft, который чинит один конкретный баг: когда в шейдерпаке включены тени от сущностей, анимации мобов и других сущностей, построенных на библиотеке GeckoLib, перестают проигрываться. Кастомные существа застывают в одной позе — и выглядят как статуи посреди мира.

Откуда берётся баг

Библиотека GeckoLib — распространённый инструмент для более сложных 3D-моделей и скелетной анимации мобов. Её используют десятки модов с собственными существами: для циклов ходьбы, дыхания, замаха оружием, агрессивных поз и т. п. Рендер сущности в Minecraft фактически выполняется несколько раз за кадр — отдельно для основной картинки и отдельно для построения карты теней. Анимация должна обновляться лишь на одном из этих проходов.

Когда шейдерпак добавляет тени от сущностей (опция Entity Shadows), модель моба рисуется повторно уже для шейдерного прохода. В старых версиях GeckoLib на этом дополнительном проходе анимационное состояние модели ломается — фрейм застревает. Без шейдера или с выключенными тенями сущностей баг не проявляется.

Что именно делает мод

GeckoAnimFix дописывает небольшую правку в поведение GeckoLib — такую, чтобы анимационный цикл моба не сбрасывался на дополнительном проходе рендера, который активируется шейдерными тенями. Сущности продолжают проигрывать свои анимации как обычно, независимо от того, какой именно шейдер включён в Iris или Oculus.

Мод работает автоматически — после того как файл .jar оказывается в папке mods/, дополнительных настроек он не требует. Никаких команд, новых блоков или внутриигровых меню не появляется: игрок замечает лишь то, что ранее сломанные мобы снова двигаются нормально.

Как подключить

Процедура установки стандартная для соответствующего загрузчика — файл .jar кладётся в папку mods/ вместе с библиотекой GeckoLib и модом шейдеров (Iris или Oculus). Отдельных служебных файлов мод в игре не создаёт.

Один нюанс, на который стоит обратить внимание: версия мода должна точно совпадать с версией Minecraft и загрузчика. Сборка для Forge не запустится на Fabric и наоборот, даже если номер версии игры одинаковый. На странице Modrinth в списке файлов для каждой версии игры отдельно отмечено, какой именно загрузчик поддерживает конкретный .jar.

Вывод

Iris/Oculus & GeckoLib Compat закрывает одну узкую задачу: возвращает жизнь анимациям кастомных мобов в Minecraft, когда пользователь не хочет отказываться от теней в своём шейдерпаке. Наибольший смысл — игра на старых модпаках 1.18.2–1.19.4 и раннем 1.20, где GeckoLib ещё не содержал собственного исправления. Ограничение прозрачно: для свежих версий GeckoLib мод уже лишний и даже может мешать модам со сложной анимацией. Аналог — простое обновление самой библиотеки GeckoLib до 4.x или новее; это делает отдельный фикс ненужным, но требует совместимых версий остальных модов в сборке.