Iris/Oculus & GeckoLib Compat — mod do naprawy animacji z shaderami w Minecraft

Iris/Oculus & GeckoLib Compat — mod do naprawy animacji z shaderami w Minecraft

Iris/Oculus & GeckoLib Compat (znany również jako GeckoAnimFix) to mały moduł kliencki do Minecraft, który naprawia jeden konkretny błąd: gdy w shaderpacku włączone są cienie od bytów, animacje mobów i innych bytów zbudowanych na bibliotece GeckoLib przestają być odtwarzane. Niestandardowe stworzenia zastygają w jednej pozie — i wyglądają jak posągi pośrodku świata.

Skąd bierze się błąd

Biblioteka GeckoLib to popularne narzędzie do bardziej złożonych modeli 3D i animacji szkieletowej mobów. Korzystają z niej dziesiątki modów z własnymi stworzeniami: do cykli chodu, oddychania, zamachu bronią, agresywnych póz i tak dalej. Renderowanie bytu w Minecraft faktycznie wykonywane jest kilka razy na klatkę — osobno dla głównego obrazu i osobno dla budowy mapy cieni. Animacja powinna być aktualizowana tylko w jednym z tych przejść.

Gdy shaderpack dodaje cienie od bytów (opcja Entity Shadows), model moba jest rysowany ponownie już dla przejścia shaderowego. W starszych wersjach GeckoLib w tym dodatkowym przejściu stan animacji modelu psuje się — klatka się zacina. Bez shadera lub z wyłączonymi cieniami bytów błąd się nie ujawnia.

Co dokładnie robi mod

GeckoAnimFix dopisuje niewielką poprawkę do zachowania GeckoLib — taką, aby cykl animacji moba nie był resetowany w dodatkowym przejściu renderowania aktywowanym przez cienie shaderowe. Byty nadal odtwarzają swoje animacje normalnie, niezależnie od tego, jaki shader jest włączony w Iris lub Oculus.

Mod działa automatycznie — po tym, jak plik .jar trafi do folderu mods/, nie wymaga żadnych dodatkowych ustawień. Nie pojawiają się żadne komendy, nowe bloki ani menu w grze: gracz zauważa jedynie to, że wcześniej zepsute moby znów poruszają się normalnie.

Jak podłączyć

Procedura instalacji jest standardowa dla odpowiedniego loadera — plik .jar umieszcza się w folderze mods/ wraz z biblioteką GeckoLib i modem shaderów (Iris lub Oculus). Mod nie tworzy w grze żadnych osobnych plików służbowych.

Jeden niuans, na który warto zwrócić uwagę: wersja moda musi dokładnie pokrywać się z wersją Minecraft i loadera. Wersja dla Forge nie uruchomi się na Fabric i odwrotnie, nawet jeśli numer wersji gry jest taki sam. Na stronie Modrinth na liście plików dla każdej wersji gry osobno zaznaczono, który loader obsługuje konkretny plik .jar.

Podsumowanie

Iris/Oculus & GeckoLib Compat zamyka jedno wąskie zadanie: przywraca życie animacjom niestandardowych mobów w Minecraft, gdy użytkownik nie chce rezygnować z cieni w swoim shaderpacku. Największy sens ma to przy grze na starych modpackach 1.18.2–1.19.4 i wczesnym 1.20, gdzie GeckoLib nie zawierał jeszcze własnej poprawki. Ograniczenie jest przejrzyste: dla świeżych wersji GeckoLib mod jest już zbędny, a nawet może przeszkadzać modom ze złożoną animacją. Alternatywą jest zwykła aktualizacja samej biblioteki GeckoLib do 4.x lub nowszej; sprawia to, że osobna poprawka staje się niepotrzebna, ale wymaga zgodnych wersji pozostałych modów w zestawie.