Gecko Lib Animation Optimizer Mod FAQ
10 questions players actually ask, answered.
How do I turn on the mod after installing it?
The mod runs automatically once installed—no activation needed. Open your in-game config menu or edit the configuration file at config/geckolib_animation_optimizer-client.toml to adjust settings like animation distances and culling options.
Why are distant mobs still animating smoothly if the mod slows them down?
The mod reduces animation tick rates for far-away mobs, not removes them entirely, so they still move naturally but update less frequently. This keeps performance high without making distant creatures look frozen.
Can I stop specific mobs from being optimized?
Yes—use the whitelist filter in your config file to list mobs that should always animate at full speed, such as mobs you're actively fighting or watching.
What's the difference between blacklist and whitelist?
Blacklist prevents certain mobs from being optimized at all. Whitelist forces only listed mobs to stay optimized while others animate normally—use whitelist to protect important mobs like bosses.
Does wall occlusion hide mobs behind blocks even if I can hear them?
Yes—occlusion culling skips rendering mobs completely when they're behind solid blocks, which improves performance but doesn't affect sounds or mob behavior.
Will the mod slow down animations on the mob I'm looking at?
No—the mod automatically prevents animation slowdown on whichever mob you're directly viewing, so combat and close encounters stay smooth.
Do I need the server to run this mod too?
No—this is a client-side only mod, so it works on any server without requiring installation or configuration on the server end.
Can I adjust how far away a mob needs to be before animations slow down?
Yes—the animation distance setting is configurable in your config file, allowing you to control the threshold where distant mob optimization kicks in.
Will this mod break my custom mob mods or datapacks?
The mod only optimizes how GeckoLib entities render and doesn't modify mob behavior, so it's compatible with most custom mob mods and datapacks.
How much FPS improvement should I expect?
Performance gains depend on how many animated mobs are nearby and your distance settings—areas with many custom creatures will show the biggest frame rate improvements.