Iris/Oculus & GeckoLib Compat — un mod pour corriger les animations avec shaders dans Minecraft

Iris/Oculus & GeckoLib Compat — un mod pour corriger les animations avec shaders dans Minecraft

Iris/Oculus & GeckoLib Compat (également connu sous le nom de GeckoAnimFix) est un petit mod côté client pour Minecraft qui corrige un bug bien précis : lorsque les ombres d'entités sont activées dans un pack de shaders, les animations des mobs et des autres entités construites sur la bibliothèque GeckoLib cessent de se jouer. Les créatures personnalisées se figent dans une seule pose — et ressemblent à des statues au milieu du monde.

D'où vient le bug

La bibliothèque GeckoLib est un outil très répandu pour les modèles 3D plus complexes et l'animation squelettique des mobs. Des dizaines de mods avec leurs propres créatures l'utilisent : pour les cycles de marche, la respiration, les coups d'arme, les poses agressives, etc. Le rendu d'une entité dans Minecraft est en réalité effectué plusieurs fois par image — séparément pour l'image principale et séparément pour construire la carte des ombres. L'animation ne doit se mettre à jour que sur l'une de ces passes.

Quand un pack de shaders ajoute des ombres d'entités (l'option Entity Shadows), le modèle du mob est redessiné, cette fois-ci pour la passe du shader. Dans les anciennes versions de GeckoLib, l'état d'animation du modèle se brise sur cette passe supplémentaire — l'image reste bloquée. Sans shader, ou avec les ombres d'entités désactivées, le bug n'apparaît pas.

Ce que fait exactement le mod

GeckoAnimFix apporte un petit ajustement au comportement de GeckoLib — un ajustement qui empêche le cycle d'animation d'un mob d'être réinitialisé lors de la passe de rendu supplémentaire déclenchée par les ombres des shaders. Les entités continuent à jouer leurs animations normalement, quel que soit le shader précis activé dans Iris ou Oculus.

Le mod fonctionne automatiquement — une fois le fichier .jar placé dans le dossier mods/, il ne nécessite aucune configuration supplémentaire. Aucune commande, aucun nouveau bloc ni menu en jeu n'apparaît : le joueur remarque seulement que les mobs auparavant cassés bougent à nouveau normalement.

Comment l'installer

La procédure d'installation est standard pour le loader concerné — le fichier .jar est placé dans le dossier mods/ avec la bibliothèque GeckoLib et le mod de shaders (Iris ou Oculus). Le mod ne crée aucun fichier de service distinct dans le jeu.

Un détail auquel il faut prêter attention : la version du mod doit correspondre exactement à la version de Minecraft et à celle du loader. Une build pour Forge ne se lancera pas sur Fabric et inversement, même si le numéro de version du jeu est identique. Sur la page Modrinth, la liste des fichiers indique séparément, pour chaque version du jeu, quel loader prend en charge un .jar donné.

Conclusion

Iris/Oculus & GeckoLib Compat règle une seule tâche bien ciblée : il redonne vie aux animations des mobs personnalisés dans Minecraft lorsque l'utilisateur ne veut pas renoncer aux ombres de son pack de shaders. Cela a le plus de sens pour jouer sur d'anciens modpacks 1.18.2–1.19.4 et le début de la 1.20, où GeckoLib ne contenait pas encore sa propre correction. La limite est claire : pour les versions récentes de GeckoLib, le mod est déjà superflu et peut même gêner les mods aux animations complexes. L'alternative consiste en une simple mise à jour de la bibliothèque GeckoLib elle-même vers la 4.x ou une version plus récente ; cela rend une correction séparée inutile, mais nécessite des versions compatibles du reste des mods de l'assemblage.