CurseForge · Minecraft mod
GeckoLib Animation Optimizer
Improves FPS by reducing unnecessary GeckoLib animation and rendering work.
Quick answer
Which GeckoLib Animation Optimizer release should I use?
GeckoLib Animation Optimizer GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar targets 1.21.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.
Where it goes
Is GeckoLib Animation Optimizer required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does GeckoLib Animation Optimizer GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar need?
GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar. Change the file and its required mods may change too.
Install GeckoLib first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.
2 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add GeckoLib Animation Optimizer without breaking your instance.
Built for GeckoLib Animation Optimizer GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install GeckoLib first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar. It opens that exact file at the source.
About this project
What does GeckoLib Animation Optimizer add?
GeckoLib Animation Optimizer
GeckoLib Animation Optimizer is a client-side performance mod designed to reduce the rendering and animation cost of entities that use GeckoLib.
The mod lowers unnecessary animation processing for distant entities and skips rendering work for entities outside the camera view. It includes configurable entity and boss filters, allowing you to control which entities may be optimized.
Features
- Distance-based GeckoLib animation throttling
- Configurable animation FPS for distant entities
- Camera frustum visibility culling
- Optional block occlusion culling
- Entity blacklist and whitelist
- Boss protection and health threshold
- Boss blacklist and whitelist
- Optional protection for the entity currently being looked at
- Configurable support for transparent and modded blocks
- Optional optimization for GeckoLib-rendered players
- Fully client-side
- In-game configuration support through compatible Forge config menu mods
Safe Default Settings
Block occlusion culling is disabled by default because large entities and bosses may have models that extend beyond their normal hitboxes.
Optimization of other players is also disabled by default.
The standard distance-based animation optimization and camera visibility culling remain enabled.
Installation
- Install Minecraft Forge for Minecraft 1.20.1.
- Install GeckoLib.
- Place GeckoLib Animation Optimizer in your
modsfolder. - Launch the game.
This optimizer is client-side and does not need to be installed on the server.
Configuration
The configuration file is located at:
config/geckolib_animation_optimizer-client.toml
You can edit the file manually or use a compatible Forge configuration menu mod.
Compatibility
This mod only affects entities rendered through GeckoLib. Normal vanilla entities and players are not modified unless another mod renders them using GeckoLib.
Performance improvements depend on the number of GeckoLib entities, their distance from the camera, and the enabled configuration options.
Important Note
Optional occlusion culling may not work perfectly with every large or unusually shaped modded entity. It is disabled by default and should be enabled only after testing it with your modpack.
License
All Rights Reserved.
Disclaimer
This project is not affiliated with or endorsed by the GeckoLib developers.
💬 Join the official Discord server for support, bug reports, suggestions, development updates, and more:
https://discord.gg/7DT8azAsYu
Project description from CurseForge.
Pick your setup
GeckoLib Animation Optimizer by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.1
1 loader build1.20.1
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
GeckoLib Animation Optimizer versions and loaders
GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar
18 Sept 2026
GeckoLib-Animation-Optimizer-1.20.1-1.0.0.jar
22 Jul 2026
Looking for an older file? The official CurseForge project page is in Resources.