GeckoLib
by Gecko
An animation library for Minecraft mods that enables complex entity animations created in Blockbench.
Overview
GeckoLib is a library mod created by Gecko. An animation library for Minecraft mods that enables complex entity animations created in Blockbench. As a library mod it concentrates on shared code that other mods build on, and it has been downloaded around 180 million times, which puts it among the options players reach for in this space.
GeckoLib is built for players installing mods that rely on it for advanced animations. GeckoLib is an animation engine many creature and machine mods use for smooth, keyframed models, so you usually install it because another mod requires it. It is a deep, systems-heavy mod, and getting the most from it means investing real time in its mechanics.
The mod is available for Forge, Fabric, NeoForge, and Quilt, so it fits a range of modpacks and launchers. It currently supports Minecraft 1.20.1, 1.20.4, and 1.21.1, spanning the 1.20.1 to 1.21.1 releases. It runs on both the client and the server, so on a multiplayer server every player who connects needs it installed alongside the server itself.
Mod Loaders
Minecraft Versions
Key Features
GeckoLib brings a focused set of features to the table. Highlights include keyframe animation support, plus blockbench integration, with the full list below.
- Keyframe animation support
- Blockbench integration
- Entity and item animations
- Particle and sound sync
- Resource pack animations
Tags
How to install GeckoLib
GeckoLib supports Forge, Fabric, NeoForge, and Quilt; pick one loader (you cannot mix them) and install it for your chosen Minecraft version. It is built for Minecraft 1.20.1, 1.20.4, and 1.21.1, so make sure your profile uses one of those versions.
- 1Choose and install one mod loader from Forge, Fabric, NeoForge, and Quilt for a Minecraft version this mod supports (1.20.1, 1.20.4, and 1.21.1).
- 2Check the download page for any required libraries. GeckoLib lists no hard dependencies here, but it is always worth confirming for your exact version.
- 3Drop the GeckoLib .jar file into your instance's mods folder. On a server, place it in the server's mods folder instead, and make sure every connecting player has it too.
- 4Launch the game with that loader profile and confirm GeckoLib appears in the in-game mods list; if it does not load, re-check the loader, the Minecraft version, and any library requirements.
Supported Minecraft versions: 1.20.1, 1.20.4, and 1.21.1. Always download the build that matches your version exactly, as mod files are version-specific.
See our full mod install guideCompatibility & alternatives
Because it ships for both Fabric and Forge-family loaders, it slots into most popular modpacks regardless of which side they are built on.
As a library mod, GeckoLib adds no content of its own and has a negligible footprint, it exists to support the mods that depend on it.
If you are comparing options, a similar mod worth a look is (no direct alternative, it is a dependency library). They overlap in purpose, so most players pick whichever suits their loader and pack.
Frequently asked questions
What does the GeckoLib mod do?
An animation library for Minecraft mods that enables complex entity animations created in Blockbench. It is a library mod by Gecko, aimed at players installing mods that rely on it for advanced animations.
Is GeckoLib Forge or Fabric?
GeckoLib supports Forge, Fabric, NeoForge, and Quilt. You only install it on one of these loaders, never several at once, so choose the one your pack uses.
What Minecraft versions does GeckoLib support?
GeckoLib supports Minecraft 1.20.1, 1.20.4, and 1.21.1. Be sure to download the file built for your specific version, since mod jars are not interchangeable across versions.
Does GeckoLib need any dependencies?
No, GeckoLib lists no required mod dependencies here, so it works as a standalone install. It is still wise to confirm on the download page for your exact version.
Can I use GeckoLib on a multiplayer server?
Yes. GeckoLib runs on client and server, so install it on the server and make sure every player who joins has the same version installed too.
Play modded Minecraft
Host a modded server with Astroworld Hosting or join our community.
Try Astroworld Hosting