Iris/Oculus & GeckoLib Compat — mod om animaties met shaders in Minecraft te repareren

Iris/Oculus & GeckoLib Compat — mod om animaties met shaders in Minecraft te repareren

Iris/Oculus & GeckoLib Compat (ook bekend als GeckoAnimFix) is een kleine client-side Minecraft-mod die één specifieke bug verhelpt: wanneer entiteitsschaduwen in een shaderpack zijn ingeschakeld, stoppen de animaties van mobs en andere entiteiten die op de GeckoLib-bibliotheek zijn gebouwd met afspelen. Aangepaste wezens bevriezen in één houding — en zien eruit als standbeelden midden in de wereld.

Waar de bug vandaan komt

De GeckoLib-bibliotheek is een veelgebruikt hulpmiddel voor complexere 3D-modellen en skeletanimatie van mobs. Tientallen mods met eigen wezens gebruiken het: voor loopcycli, ademhaling, het zwaaien met wapens, agressieve houdingen enzovoort. Het renderen van een entiteit in Minecraft gebeurt in feite meerdere keren per frame — apart voor het hoofdbeeld en apart voor het opbouwen van de schaduwkaart. De animatie mag slechts tijdens één van deze passes worden bijgewerkt.

Wanneer een shaderpack entiteitsschaduwen toevoegt (de optie Entity Shadows), wordt het model van de mob opnieuw getekend voor de shader-pass. In oudere versies van GeckoLib raakt de animatiestatus van het model tijdens deze extra pass beschadigd — het frame loopt vast. Zonder shader of met uitgeschakelde entiteitsschaduwen treedt de bug niet op.

Wat de mod precies doet

GeckoAnimFix voegt een kleine aanpassing toe aan het gedrag van GeckoLib — zodanig dat de animatiecyclus van een mob niet wordt gereset tijdens de extra renderpass die door shaderschaduwen wordt geactiveerd. Entiteiten blijven hun animaties normaal afspelen, ongeacht welke shader er in Iris of Oculus is ingeschakeld.

De mod werkt automatisch — zodra het .jar-bestand in de map mods/ staat, heeft het geen aanvullende instellingen nodig. Er verschijnen geen commando's, nieuwe blokken of menu's in het spel: de speler merkt alleen dat eerder kapotte mobs weer normaal bewegen.

Hoe te installeren

De installatieprocedure is standaard voor de betreffende loader — het .jar-bestand wordt in de map mods/ geplaatst, samen met de GeckoLib-bibliotheek en de shader-mod (Iris of Oculus). De mod maakt geen aparte servicebestanden aan in het spel.

Eén ding waar je op moet letten: de versie van de mod moet exact overeenkomen met de Minecraft-versie en de loader. Een build voor Forge start niet op Fabric en omgekeerd, zelfs als het versienummer van het spel gelijk is. Op de Modrinth-pagina staat in de bestandslijst voor elke spelversie apart aangegeven welke loader een specifiek .jar-bestand ondersteunt.

Conclusie

Iris/Oculus & GeckoLib Compat lost één specifieke taak op: het blaast nieuw leven in de animaties van aangepaste mobs in Minecraft wanneer de gebruiker de schaduwen in zijn shaderpack niet wil opgeven. Het meest zinvol is dit bij het spelen op oude modpacks 1.18.2–1.19.4 en het vroege 1.20, waar GeckoLib nog geen eigen oplossing bevatte. De beperking is duidelijk: voor recente versies van GeckoLib is de mod al overbodig en kan hij zelfs storend zijn voor mods met complexe animatie. Het alternatief is simpelweg het bijwerken van de GeckoLib-bibliotheek zelf naar 4.x of nieuwer; dat maakt een aparte fix overbodig, maar vereist compatibele versies van de overige mods in de build.