Iris/Oculus & GeckoLib Compat Mod Wiki

Iris/Oculus & GeckoLib Compat Mod Wiki & Guide

wiki.9minecraft.net/iris-oculus-geckolib-compat-mod/

Iris/Oculus & GeckoLib Compat Mod resolves animation issues for GeckoLib entities when using shaderpacks with entity shadows. It ensures maintaining visual quality and performance. Practical enhancements support shaderpack users relying on GeckoLib entities.

Guides

Step-by-step, in-game.

Diagnosing Whether a Broken Mob Animation Is the Shader Conflict or the Mod ItselfIsolate the Cause Not every animation glitch comes from the shader shadow conflict. Work through these checks in…How to Fix GeckoLib Mob Animations Breaking When You Enable Shader ShadowsConfirm the Conflict First Before changing anything, verify that the problem is actually the shader shadow…Keeping Framerate Stable With GeckoLib Mobs and Shader Shadows EnabledUnderstand the Cost With the compat mod installed, GeckoLib mobs animate correctly under shader shadows — but that…Making Custom GeckoLib Mobs Cast Correct Shadows Without Losing AnimationWhy Shadows and Animations Fight GeckoLib renders mobs by deforming a model through a bone hierarchy each frame.…

Frequently asked questions

What does the Iris/Oculus & GeckoLib Compat Mod actually do?

It patches the conflict between shaderpack entity shadows and GeckoLib's animated models, so your custom mobs keep animating correctly instead of freezing or glitching when shadows are enabled. Without it, GeckoLib entities often lose their animation state the moment a shader renders their shadow.

Do I need to configure anything after installing it?

No, it works passively once installed alongside Iris or Oculus and GeckoLib. Just make sure all three mods are present and enabled, then launch the game with your shaderpack as usual.

My GeckoLib mob animations are still broken with shaders on. What should I check first?

Confirm the compat mod is actually loaded and that your shaderpack has entity shadows enabled, since the fix only applies when shadows are being rendered. If animations still break, test with shadows off to see whether the issue is the shader conflict or the mob's own model/animation files.

Does this mod work with both Iris and Oculus?

Yes, it targets both loaders' shader pipelines, so it covers Fabric setups using Iris and Forge/NeoForge setups using Oculus. You only need the version matching your loader.

See all 10 Iris/Oculus & GeckoLib Compat questions ›

Other wikis you may find useful.