Iris/Oculus & GeckoLib Compat: un mod para corregir las animaciones con shaders en Minecraft

Iris/Oculus & GeckoLib Compat: un mod para corregir las animaciones con shaders en Minecraft

Iris/Oculus & GeckoLib Compat (también conocido como GeckoAnimFix) es un pequeño mod del lado del cliente para Minecraft que corrige un error muy concreto: cuando en un paquete de shaders están activadas las sombras de entidades, las animaciones de los mobs y otras entidades construidas sobre la biblioteca GeckoLib dejan de reproducirse. Las criaturas personalizadas se congelan en una sola pose, y parecen estatuas en medio del mundo.

De dónde viene el error

La biblioteca GeckoLib es una herramienta muy usada para modelos 3D más complejos y la animación esquelética de los mobs. Decenas de mods con sus propias criaturas la utilizan: para ciclos de caminata, respiración, golpes de arma, poses agresivas, etc. El renderizado de una entidad en Minecraft se realiza en realidad varias veces por fotograma: por separado para la imagen principal y por separado para construir el mapa de sombras. La animación solo debe actualizarse en una de esas pasadas.

Cuando un paquete de shaders añade sombras de entidades (la opción Entity Shadows), el modelo del mob se dibuja de nuevo, esta vez para la pasada del shader. En versiones antiguas de GeckoLib, el estado de animación del modelo se rompe en esa pasada adicional: el fotograma se queda atascado. Sin shader, o con las sombras de entidades desactivadas, el error no aparece.

Qué hace exactamente el mod

GeckoAnimFix añade un pequeño ajuste al comportamiento de GeckoLib, uno que evita que el ciclo de animación de un mob se reinicie en la pasada de renderizado adicional que activan las sombras de los shaders. Las entidades siguen reproduciendo sus animaciones con normalidad, independientemente de qué shader concreto esté activado en Iris u Oculus.

El mod funciona automáticamente: una vez que el archivo .jar está en la carpeta mods/, no necesita ninguna configuración adicional. No aparecen comandos, bloques nuevos ni menús dentro del juego: el jugador solo nota que los mobs que antes estaban rotos vuelven a moverse con normalidad.

Cómo instalarlo

El procedimiento de instalación es el estándar para el loader correspondiente: el archivo .jar se coloca en la carpeta mods/ junto con la biblioteca GeckoLib y el mod de shaders (Iris u Oculus). El mod no crea archivos de servicio aparte dentro del juego.

Un detalle al que conviene prestar atención: la versión del mod debe coincidir exactamente con la versión de Minecraft y la del loader. Una compilación para Forge no funcionará en Fabric y viceversa, aunque el número de versión del juego sea el mismo. En la página de Modrinth, la lista de archivos indica por separado, para cada versión del juego, qué loader admite un .jar concreto.

Conclusión

Iris/Oculus & GeckoLib Compat resuelve una tarea muy concreta: devuelve la vida a las animaciones de los mobs personalizados en Minecraft cuando el usuario no quiere renunciar a las sombras de su paquete de shaders. Tiene más sentido al jugar con modpacks antiguos 1.18.2–1.19.4 y 1.20 temprano, donde GeckoLib aún no incluía su propia corrección. La limitación es clara: para versiones recientes de GeckoLib el mod ya es innecesario e incluso puede interferir con mods que tienen animaciones complejas. La alternativa es una simple actualización de la propia biblioteca GeckoLib a la 4.x o más reciente; eso hace innecesaria una corrección aparte, pero requiere versiones compatibles del resto de los mods de la compilación.