CurseForge · Minecraft mod
GeckoLib
A 3D animation library for entities, blocks, items, armor, and more!
Quick answer
Which GeckoLib release matches 1.21.7 NeoForge?
GeckoLib 5.2.1 targets 1.21.7, 1.21.8 with NeoForge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is GeckoLib required on the client, server, or both?
Installation on the client is optional. Installation on the dedicated server is optional.
The source marks this as usable on both the client and server.
What else does GeckoLib 5.2.1 need?
5.2.1 on 1.21.7 NeoForge. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add GeckoLib without breaking your instance.
Built for GeckoLib 5.2.1 on 1.21.7 NeoForge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 5.2.1. It targets 1.21.7, 1.21.8 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
Installation on the client is optional. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 5.2.1. It opens that exact file at the source.
About this project
What does GeckoLib add?
GeckoLib is an animation and rendering engine for Minecraft Mods, with support for complex 3D keyframe-based animations, 30+ easings, concurrent animation support, sound and particle keyframes, event keyframes, and more. Available for Forge, Fabric, and NeoForge
You can view installation instructions for modders here.
For non-modders, just download the mod and put it in your mods folder like normal.
GeckoLib provides detailed documentation in the form of a wiki. We spent many hours writing the wiki, so please read it!
If you have questions or need help getting up and running with questions, join our discord!
Pull requests are welcome. For significant changes, please open an issue first to discuss what you would like to change.
Sponsored by BisectHosting
Need a server to play with friends? Don't know how to setup one? Just rent an already configured server from BisectHosting!
Click on the picture above, select plan(at least 4GB), and use my code gecko to get 25% off your first month and enjoy playing with your friends!
Header image made by JoLee
Project description from CurseForge.
Pick your setup
GeckoLib by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
3 loader builds26.1
2 loader builds1.21.11
3 loader builds1.21.10
3 loader builds1.21.8
3 loader builds1.21.7
3 loader builds1.21.6
3 loader builds1.21.1
3 loader builds1.20.1
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
GeckoLib versions and loaders
5.2.1
geckolib-neoforge-1.21.7-5.2.1.jar
3 Jul 2025
5.2.0
geckolib-neoforge-1.21.7-5.2.0.jar
1 Jul 2025
Looking for an older file? The official CurseForge project page is in Resources.