GeckoLib – Minecraft Animation Library Mod

Download GeckoLib from Modrinth

What GeckoLib Does

GeckoLib is an animation library that mod developers use to add smooth, complex animations to their mods. It works with Blockbench’s JSON animation format, so a mod author can design a creature’s walk cycle or attack animation visually in Blockbench and export it straight into the game without hand-coding every keyframe.

GeckoLib itself adds nothing to your world. No new mobs, no new blocks, no gameplay changes. It’s an engine that other mods plug into. If you downloaded something and got a crash or a “missing dependency” error that mentions GeckoLib, this is the file you need to drop in your mods folder.

Why Hundreds of Mods Depend on It

Vanilla Minecraft’s animation system is limited. You can rotate limbs on entities, and that’s basically it. GeckoLib gets around that with a full animation framework that supports smooth interpolation, multiple animation layers, particles tied to keyframes, and more. The end result is mobs that actually look alive instead of snapping stiffly between poses.

Alex’s Mobs, Ice and Fire, Ars Nouveau, L_Ender’s Cataclysm, Mutant Monsters, Alexis’s End Remastered – these are all mods with dozens of custom animated creatures, and they all list GeckoLib as a hard requirement. Without it in your mods folder, they crash on launch or simply refuse to load.

Key Features

Blockbench Animation Support

GeckoLib reads the same animation JSON format that Bedrock Edition uses. Any mod author who already knows Blockbench can use GeckoLib without learning a new tool. Keyframes, easing curves, looping animations – it all transfers directly from the editor into the game.

Multiple Animation Layers Running at Once

Different animations can play on different bone groups of the same model simultaneously. A mob can walk, look around, breathe, and wag its tail all at the same time, with each animation running independently on its own set of bones. Vanilla can’t do this cleanly.

Particles and Sounds on Timelines

GeckoLib lets mod authors trigger particle effects and sounds at specific points in an animation. That’s how attack animations spawn impact particles at the exact frame of contact, or how creatures vocalize in sync with their movement. It’s all defined in the animation file, not hardcoded.

Entity, Block, and Item Animations

It works on more than mobs. Blocks and items can use GeckoLib too, which is why some mods have animated machinery, opening containers, or handheld weapons with custom swing animations that go well beyond what vanilla rendering allows.

Server and Client Both Need It

GeckoLib has to be installed on both client and server. The server handles animation state logic (which animation should be active and when), and the client handles the actual rendering. Leaving it off the server causes disconnects or startup crashes.

Supported Versions and Mod Loaders

GeckoLib has two major versions in active use right now:

• GeckoLib 3.x – Minecraft 1.12 through 1.19.x, with support for Forge, Fabric, and Quilt
• GeckoLib 4.x – Minecraft 1.19.4 and newer, adding NeoForge support alongside Forge and Fabric

The version numbers have to match exactly. If a mod page says it requires GeckoLib for Fabric 1.20.1, download the GeckoLib build for Fabric 1.20.1 specifically. A build for 1.20 or 1.20.4 won’t do.

How to Install GeckoLib

GeckoLib installs the same way as any other mod. The only thing that matters is getting the right version for your setup.

1. Check your Minecraft version and loader. Look at the mod that requires GeckoLib and note which Minecraft version and loader it’s built for – Forge, Fabric, Quilt, or NeoForge. If you haven’t installed a loader yet, do that first: Forge, Fabric, Quilt, or NeoForge.
2. Download GeckoLib. Use the download button on this page and pick the build that matches your Minecraft version and loader exactly.
3. Open your mods folder. In the Minecraft launcher, click “Installations,” hover over your modded profile, and click the folder icon. Or navigate to .minecraft/mods directly on your system.
4. Drop the .jar file in. Copy the downloaded file into the mods folder. No unzipping, no renaming – just drop it in.
5. Launch using your modded profile. If GeckoLib loaded correctly, you won’t see anything different in the menu. It runs entirely in the background. Install your other mods the same way and launch again.

If you want a full walkthrough of the mods folder process, the Forge mod install guide and the Fabric install guide cover each step in detail.