GeckoLib — the Library That Animates Every Modded Boss
Forge · Fabric · NeoForge · 411M downloads

GeckoLib: what animated mobs are built on

GeckoLib is the keyframe animation library behind most animated mobs, bosses, blocks, and armor in modded Minecraft. It adds no content of its own — it is the system other mods use to animate their 3D models. If a mod page says "requires GeckoLib," this is the one. Without it, that custom boss you just installed will not spawn, will not animate, or will crash the game before the title screen.

Forge / Fabric / NeoForge Minecraft 26.3 Library / API Verified source

Quick facts

CategoryLibrary / API
LoadersForge, Fabric, NeoForge
Minecraft26.3 and older supported versions
AuthorGecko
SourceCurseForge
Downloads411.4M (CurseForge, Sep 2026)
SideClient and server (depends on dependent mod)

Source status

Verified

The download below is the file listed in our catalogue. Metadata last checked November 2026.

View on CurseForge →

Opens CurseForge in a new tab. CurseForge's terms apply.

Minecraft Mod

What animated mobs are built on

GeckoLib screenshot showing an animated modded boss mid-attack, with wing-flap and idle animations driven by the library
An animated modded boss mid-attack, running on GeckoLib. The wing-flap, the idle motion, and the attack sequence are all keyframe animations played back by the library — vanilla Minecraft has no system for this kind of 3D animation.
External link

Get GeckoLib

One JAR per loader. Drop into mods alongside the dependent mod — the version must match both loader and Minecraft version.

Visit GeckoLib

File: geckolib.zip · External — creator's site · No redirects, no ads

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

1
Keyframe animationHand-authored 3D animation for custom models — the system vanilla Minecraft was never designed to handle.
2
Entities, blocks, items, armorFour animation targets, each with its own renderer integration — the library covers all four.
3
Multi-loader supportThe same animations play on Forge, Fabric, and NeoForge — the mod does not branch per loader.
4
No content of its ownGeckoLib adds nothing visible to the game by itself. It is infrastructure the dependent mods rely on.

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.

  1. Install the loader that the dependent mod requires — Forge, Fabric, or NeoForge.
  2. 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.
  3. Place GeckoLib and the dependent mod in the mods folder together. Subfolders inside mods usually work, but some launchers have issues — safest to keep both JARs at the top level.
  4. Launch the game. GeckoLib does not appear as a separate item or menu — it works silently in the background.
Version matching. GeckoLib versions are tied to Minecraft versions. A GeckoLib build for 1.20.1 will not work on 1.21.1. Check the file list on CurseForge and pick the build that matches both your loader and your Minecraft version — this is the single most common cause of "GeckoLib is missing" errors after a correct install.

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.

FieldValue
CategoryLibrary / API
LoadersForge, Fabric, NeoForge
Minecraft versions26.3 and older supported versions
SideClient and server (depends on dependent mod)
SourceCurseForge (Gecko)
Downloads411.4M (CurseForge, Sep 2026)
Last verifiedNovember 2026

Frequently asked questions

I installed GeckoLib but the mod still says it is missing.
The most common cause is a version mismatch. Check that the GeckoLib version matches the dependent mod's required version and your Minecraft version. Also check that GeckoLib is in the mods folder, not a subfolder.
Can I use GeckoLib with other animation libraries?
GeckoLib is generally compatible with other libraries because it is dependency-based. If a mod requires a different animation library, install both. They serve different mods and do not usually conflict.
Does GeckoLib work on Bedrock?
No. GeckoLib is a Java Edition mod library.
How do I know if a mod needs GeckoLib?
The mod page will list it under "Dependencies" or "Relations." If you skip it, the game will crash on launch with a message naming GeckoLib as the missing dependency.
Do I need GeckoLib on the server?
It depends on the dependent mod. If the mod is server-side (adds mobs, bosses, or blocks that need to exist on the server), then GeckoLib must be installed on both client and server. If the mod is client-side only, GeckoLib may only be needed on the client.

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.