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 або новіше; це робить окремий фікс непотрібним, але потребує сумісних версій решти модів у збірці.