Iris, Oculus и GeckoLib: зачем был нужен совместимый мод и почему он устарел
Если вы собираете сборку Minecraft с шейдерами и анимированными существами из модов, вы наверняка сталкивались с парой имён: Iris и Oculus на стороне шейдеров, и GeckoLib на стороне моделей и анимаций. Отдельно всё работает отлично, а вместе иногда возникали странные баги: моб «замер», части тела не крутятся, цикл анимации обрывается — особенно заметно на сборках с тяжёлыми shaderpack и включёнными тенями сущностей. Именно под такие случаи когда-то и появился небольшой технический мост — мод совместимости между Iris/Oculus и GeckoLib.
Что делал мод совместимости
По сути, он чинил ситуацию, когда анимации сущностей GeckoLib не отрабатывали при использовании паков шейдеров, у которых есть entity shadows — тени для сущностей. Это не «косметика ради красоты»: тени сущностей заметно меняют рендер-пайплайн, и в определённых связках версий модов и шейдерного стека анимация могла ломаться так, что визуально казалось, будто мод вообще не подгрузил анимационный контроллер.
Мод не добавлял новых блоков и биомов — это чисто техническая заплатка для стабильной работы механик отрисовки. Для игрока результат простой: существа снова «оживали» там, где шейдеры раньше их «глушили».
Почему мод помечен как Deprecated
Со временем GeckoLib обновился, и разработчики закрыли источник проблемы на своей стороне. Для актуальных веток на версии 1.20.1+ отдельная совместимость чаще всего уже не нужна: свежие сборки получают исправления прямо в основном моде, а не через «прослойку» между шейдерами и библиотекой анимаций.
Если вы поднимаете сервер или клиент на свежих обновлениях и держите GeckoLib в разумной актуальности, логика простая: сначала обновите GeckoLib и проверьте поведение с вашим shaderpack. В большинстве сценариев лишний мод только усложнит список зависимостей и отладку конфликтов.
Когда его всё ещё имеет смысл ставить
Исключение — «наследие»: вы сидите на старом наборе модов, не можете быстро перейти на новую ветку GeckoLib, и после включения шейдеров с тенями сущностей анимации снова превращаются в статичные картинки. Тогда совместимость может оказаться единственным быстрым способом вернуть нормальный цикл анимации без полной пересборки модпака.
Практический чек-лист выглядит коротко: отключите шейдеры и проверьте анимацию; включите шейдеры без теней сущностей; включите тени сущностей и сравните. Если баг воспроизводится только в последнем варианте — вы попали в тот самый класс проблем, под который когда-то писали фикс.
Отдельно стоит сказать про удобство установки: если вы любите эксперименты с модами и часто пересобираете клиент, этот мод можно легко установить через лаунчер foxygame.net — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню, не прыгая по десятку страниц с инструкциями.
Как это вписывается в экосистему шейдеров
Iris на Fabric (и родственные решения вроде Oculus на NeoForge) отвечают за то, чтобы ваш Minecraft красиво «красился» шейдерами, не превращая игру в слайд-шоу без причины. GeckoLib — это инфраструктура для анимированных моделей в модах: от мобов до боссов и декоративных существ. Конфликт возникал не потому, что «шейдеры плохие» или «GeckoLib кривой», а потому что разные слои рендера иногда спорят о том, как и когда обновлять данные анимации.
Вывод: ставить или не ставить
Сегодня этот мод — скорее архивная страховка, чем обязательная часть сборки. На свежих версиях с обновлённым GeckoLib начинать стоит без него и добавлять только если вы точно видите регрессию анимаций на старом стеке. Для стабильной игры полезнее держать в порядке три опоры: актуальный GeckoLib, совместимый с вашим загрузчиком набор шейдеров и понятный минимум модов, которые реально трогают рендер.
Если после обновлений всё выглядит правильно — поздравляю, вы сэкономили себе лишний узел зависимостей. Если нет — у вас есть понятная диагностика: шейдеры, тени сущностей, версия GeckoLib. Именно эта связка чаще всего объясняет, почему «на бумаге» всё совместимо, а в игре персонажи вдруг перестали шевелиться.