Iris/Oculus & GeckoLib Compat Mod (1.21) – No More Animation Glitches

Iris/Oculus & GeckoLib Compat Mod is a compatibility mod that fixes GeckoLib animations not working when shaderpacks with entity shadows are enabled for Minecraft Fabric, Forge, and NeoForge setups. It is made for players who want animated GeckoLib entities to keep working correctly while using shaders.

The reason this mod matters is simple: shaderpacks can make a world look better, but they can also introduce strange edge cases, and broken GeckoLib animations are one of the more annoying ones because they affect how mobs, creatures, or animated models actually appear in play. This mod focuses on that exact problem rather than trying to be a giant overhaul, which is probably why it has passed 6 million downloads on Modrinth. When a fix reaches that level of adoption for such a narrow issue, it usually means plenty of players ran into the same conflict and needed a practical answer.

Key Features of Iris/Oculus & GeckoLib Compat Mod

• Fixes GeckoLib animation issues with shaderpacks using entity shadows — This is the core reason to install the mod, and it directly addresses the rendering conflict described by the author. If you have ever had animated GeckoLib entities behave incorrectly once entity shadows were involved, this kind of focused patch can make the rest of your setup feel consistent again.
• Built specifically around Iris and Oculus shader environments — The title makes it clear this mod is aimed at the intersection between Iris or Oculus and GeckoLib content. That matters because it tells you the mod is not a vague "maybe it helps" tweak, but a targeted compatibility layer for a known combination many players actually use.
• Useful for modpacks that depend on animated entities — GeckoLib is often the piece behind custom entity animation, so when its animations stop working, the whole presentation of a pack can suffer. A compatibility fix like this helps preserve the intended look and feel of those animated encounters instead of forcing you to choose between shaders and animation support.
• Supports Fabric, Forge, and NeoForge — Broad loader coverage is a real advantage because you do not have to rebuild your entire pack around one ecosystem just to chase a compatibility solution. Whether your setup leans Fabric or stays on the Forge side, this mod appears positioned to serve the same purpose across all three loaders listed.
• Available across a wide spread of Minecraft versions — The supported versions run from 1.18.2 up to 1.21, which gives this project a much longer usable life than a one-version fix. That is valuable if you maintain several instances, test old packs, or are not ready to move every world to the newest release right away.
• Open-source project with an MIT license — The source code is publicly listed, and the MIT license is a straightforward, permissive license. For players and pack builders, that usually adds confidence because the project is easier to inspect, track, and follow over time.

Screenshots

How to Install Iris/Oculus & GeckoLib Compat Mod

1. Choose the file that matches your exact Minecraft version, such as 1.21, 1.20.6, or 1.20.1, because compatibility fixes work best when the game version and mod version line up cleanly.
2. Install the correct mod loader for your setup: Fabric Mod Loader, Minecraft Forge, or NeoForge.
3. Make sure your modpack already includes the GeckoLib-based content and the shader setup you actually use, since this mod is meant to resolve the interaction between those parts rather than replace them.
4. Place the Iris/Oculus & GeckoLib Compat Mod file into your Minecraft mods folder for the same profile or instance where you use shaders.
5. Launch the game, enable your shaderpack, and test an affected GeckoLib entity with entity shadows on to confirm the animation issue is resolved in your own setup.

Requirements & Compatibility

What's New

• The listed update notes say the start warning screen issue was fixed.
• The changelog also notes that this version had previously been missed on Modrinth and was uploaded afterward.
• Modrinth metadata shows the latest update date as March 16, 2024, following the original publication on January 7, 2024.

Pros and Cons

Alternatives to Iris/Oculus & GeckoLib Compat Mod

• Iris Shaders — A complementary option for players building a shader-focused setup around the Iris side of the compatibility issue named by this mod.
• Oculus — A related choice for Forge or NeoForge shader users who want to understand the other half of the shader environment this mod is designed around.
• GeckoLib — The animation library at the center of this fix, making it the most relevant companion page if you want to understand what content is affected.

Download Iris/Oculus & GeckoLib Compat Mod

Always download mods from official sources to stay safe.

Frequently Asked Questions

What does Iris/Oculus & GeckoLib Compat Mod actually fix?

It fixes GeckoLib entity animations that stop working when a shaderpack uses entity shadows. In plain terms, it is meant to smooth out the conflict between shader rendering and GeckoLib-based animation behavior.

Do I need this mod if I do not use shaders?

No — if you do not use shaderpacks, this mod is much less likely to matter for your setup. Its stated purpose is tied specifically to shaderpacks with entity shadows.

Does it support Fabric, Forge, and NeoForge?

Yes — the listed mod types include Fabric, Forge, and NeoForge. That gives it broader usefulness than a one-loader-only compatibility patch.

Which Minecraft versions can I use it on?

It supports versions from 1.18.2 up to 1.21. That includes 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, and 1.20.6 as well.

Is this a full content mod with new items or mobs?

No — this is a compatibility-focused mod, not a content expansion. Its value comes from fixing a rendering and animation issue rather than adding new gameplay systems.

Is the source code available?

Yes — the project lists a public GitHub source URL. That is useful if you want to inspect the project directly or keep an eye on future changes.

You May Also Like

Rubidium Mod (1.21.11, 1.20.1) – Sodium for Forge, Rubidium Extras

1 week ago

Saturn Mod (1.21.1, 1.20.1) – Optimise Performance

2 weeks ago

YUNG's Better Strongholds Mod (1.21.4, 1.20.4) – Gameplay Upgrade

1 month ago

Troll Commands Mod (1.21.11) – How To Prank Your Friends In Minecraft

2 weeks ago

AAA Particles Mod (1.21.1, 1.20.1) – New Lightning Effect

1 week ago

Animal Feeding Trough Mod (1.21.11, 1.20.6) – Automate Mob Breeding

5 days ago