Geckolib

Geckolib

A 3D animation library for entities, blocks, items, armor, and more!

41.3M downloads
Created Apr 9, 2026
by Gecko

About

<center> <img src="https://github.com/user-attachments/assets/77a85ba0-86c0-41ee-b06d-4cc265a4a2a0" alt="logo"/>

<a href="https://discord.gg/pPEqBgJtZW"><img src="https://img.shields.io/discord/730912704776110121?color=green&label=Discord&logo=Discord&logoColor=green&style=for-the-badge" alt="discord"/></a> <a href="https://www.patreon.com/geckosmods"><img src="https://img.shields.io/endpoint.svg?url=https://shieldsio-patreon.vercel.app/api?username=geckosmods&type=patrons&style=for-the-badge&color=green&logoColor=green" alt="patreon"/> </a>

<h1 style="font-size:10vw">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</h1> <img src="https://github.com/user-attachments/assets/cc9c7ee8-ddcc-4826-9836-801a8b69045b" alt="Installation"/> <h3>You can view installation instructions for modders <a href="https://github.com/bernie-g/geckolib/wiki/Installation">here</a>. </br>

For non-modders, just download the mod and put it in your mods folder like normal.</h3>

<img src="https://github.com/user-attachments/assets/f43b07d1-c652-4371-9755-578ab04e1b39" alt="Documentation"/>

GeckoLib provides detailed documentation in the form of a <a href="https://github.com/bernie-g/geckolib/wiki">wiki</a>. We spent many hours writing the wiki, so please read it!

<img src="https://github.com/user-attachments/assets/f61e887e-12fb-4264-a120-e782b48f0508" alt="Support"/>

If you have questions or need help getting up and running with questions, join our discord!

<img src="https://github.com/user-attachments/assets/bcf11ebf-c7d2-41f8-981a-8df6d7b9158e" alt="Contributing"/> Pull requests are welcome. For significant changes, please open an issue first to discuss what you would like to change.

<a href="https://github.com/bernie-g/geckolib"><img src="https://github-readme-stats.vercel.app/api/pin/?username=bernie-g&repo=geckolib&theme=merko"></a>

<img src="https://github.com/user-attachments/assets/c01efae5-9cda-4f68-82f5-f0c99f3ff84a" alt="License"/> <img src="https://img.shields.io/github/license/bernie-g/geckolib?style=for-the-badge" alt="logo"/> <h1 style="font-size:10vw">Sponsored by BisectHosting</h1>

Need a server to play with friends? Don't know how to setup one? Just rent an already configured server from BisectHosting!

<a href="https://bisecthosting.com/gecko"><img src="https://github.com/user-attachments/assets/a97896c2-c19a-4143-acb2-e7de6e4a47c2" alt="Bisect Hosting"></a>

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!

</center>

Versions

v4.8.4Latest
1.21.1neoforgeMar 3, 2026

v4.8.4 - Prevent crashing from an empty molang string - Fixed Molang calculations sometimes parsing math incorrectly (#820) - Fixed MathParser not parsing group negatives properly (#820)

Download

Download

Download v4.8.4

Minecraft: 1.21.1

Loaders: neoforge

Tags

fabricforgeneoforgequilt1.21.61.21.71.21.81.21.101.21.11