Quick facts
| Category | Library / API |
| Loaders | Forge, Fabric, NeoForge |
| Minecraft | 26.3 and older supported versions |
| Author | Gecko |
| Source | CurseForge |
| Downloads | 411.4M (CurseForge, Sep 2026) |
| Side | Client and server (depends on dependent mod) |
Source status
Verified
The download below is the file listed in our catalogue. Metadata last checked November 2026.
Opens CurseForge in a new tab. CurseForge's terms apply.
What animated mobs are built on
Get GeckoLib
One JAR per loader. Drop into mods alongside the dependent mod — the version must match both loader and Minecraft version.
What GeckoLib actually does
GeckoLib is not a content mod. It adds no mobs, no bosses, no items. It is a library that other mods use to animate 3D models — keyframe-based animation for entities, blocks, items, and armor. Vanilla Minecraft's animation system was designed for vanilla mobs with simple limb movement, and it cannot handle the hand-authored 3D sequences that modded bosses use. GeckoLib fills that gap.
The consequence for players is straightforward: if a mod depends on GeckoLib, installing the mod without GeckoLib produces a broken experience. Depending on how the mod was written, the game may crash on startup, the mob may spawn frozen in its default pose, or the boss may not spawn at all. The mod page will list GeckoLib under Dependencies; if it does, install it.
The scale of dependency is large. Hundreds of mods list GeckoLib in their requirements — everything from small mob-addition mods to major content overhauls. If you have played modded Minecraft at all, you have probably used it, even if you never saw it in a mod list. That is the nature of a library: it is invisible until it is missing.
What it enables in other mods
GeckoLib's feature set is best understood by what other mods do with it, not by what the library itself exposes. Four categories cover most of it:
- Animated entities. Custom mobs and bosses with walk cycles, attack sequences, and idle fidgeting. The dragon with the wing-flap animation, the boss with the phase transition, the pet with the tail wag — all GeckoLib.
- Animated blocks. Moving parts, rotating components, and interactive block models. Machines that look like they are working rather than static models with a GUI.
- Animated items. Items with idle or held animations — a floating crystal, a pulsing sword, a lantern that swings when you walk.
- Animated armor. Armor sets with custom bone-based animations — wings that flap, capes that flutter, helmets with animated visors.
None of these are GeckoLib features in the sense of "GeckoLib adds them to your game." They are features that other mods can build because GeckoLib exists. The library provides the animation playback system; the mod provides the model and the keyframes.
What the library provides
How to install it (version matching is the whole job)
GeckoLib must match the dependent mod's version and your Minecraft version. A GeckoLib build for 1.20.1 will not work with a 1.21 mod. Install it alongside the dependent mod, in the same mods folder — and check the file list carefully, because GeckoLib ships builds for many MC versions and the wrong one will crash on startup.
- Install the loader that the dependent mod requires — Forge, Fabric, or NeoForge.
- Download the GeckoLib JAR from CurseForge for your exact loader and Minecraft version. Check the file list carefully — GeckoLib ships builds for many MC versions.
- Place GeckoLib and the dependent mod in the
modsfolder together. Subfolders insidemodsusually work, but some launchers have issues — safest to keep both JARs at the top level. - Launch the game. GeckoLib does not appear as a separate item or menu — it works silently in the background.
Do you need GeckoLib on a server?
If the dependent mod is server-side — it adds mobs, bosses, or blocks that need to exist on the server — then GeckoLib must be installed on both the client and the server. If the dependent mod is client-side only, GeckoLib may only be needed on the client. Check the dependent mod's page for its side requirements — that is the authoritative source, not the GeckoLib page itself. A mod that spawns a boss needs GeckoLib on both ends; a mod that only renders a cosmetic overlay may need it only on the client.
Compatibility at a glance
Every value below comes from the creator's official source page. Where the creator doesn't state a field, we mark it "Unknown" rather than guess.
| Field | Value |
|---|---|
| Category | Library / API |
| Loaders | Forge, Fabric, NeoForge |
| Minecraft versions | 26.3 and older supported versions |
| Side | Client and server (depends on dependent mod) |
| Source | CurseForge (Gecko) |
| Downloads | 411.4M (CurseForge, Sep 2026) |
| Last verified | November 2026 |
Frequently asked questions
I installed GeckoLib but the mod still says it is missing.
mods folder, not a subfolder.Can I use GeckoLib with other animation libraries?
Does GeckoLib work on Bedrock?
How do I know if a mod needs GeckoLib?
Do I need GeckoLib on the server?
Why this listing exists
Most resource sites either dump hundreds of unverified links with no context, or hide downloads behind fake countdown timers and redirect chains. This page follows a different approach: it shows the resource's real metadata, links to the creator's original page, and states clearly what we have and have not verified.
If you find a broken link, an incorrect version, or a download that goes somewhere unexpected, report it using the contact form. If you are the creator and want this listing removed or changed, see Copyright / DMCA.
Related mods
Report a problem with this page: contact form. If you are the creator and want this listing changed, see Copyright / DMCA.