Back to mods
GeckoLib Animation Optimizer project artwork

CurseForge · Minecraft mod

GeckoLib Animation Optimizer

Improves FPS by reducing unnecessary GeckoLib animation and rendering work.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which GeckoLib Animation Optimizer release should I use?

Updated today
Latest stable file GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar
Game version 1.21.1
Loader NeoForge

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

All 1 required mods have matching files

Install GeckoLib first. We found matching files for this game-version and loader setup. 2 come through another mod in the chain.

2 listed on this file 2 pulled in by those mods
Configured Optional for GeckoLib Animation Optimizer GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar
optional
Matching file found Matched file: Configured 2.6.3
GeckoLib Needed by GeckoLib Animation Optimizer GeckoLib-Animation-Optimizer-1.21.1-1.0.0.jar
required
Matching file found Matched file: NeoForge 1.21.1 4.9.3
Framework Needed by Configured
pulled in
Matching file found Matched file: Framework 0.13.11
Catalogue Needed by Configured
pulled in
Matching file found Matched file: Catalogue 1.11.2

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 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

  1. Install Minecraft Forge for Minecraft 1.20.1.
  2. Install GeckoLib.
  3. Place GeckoLib Animation Optimizer in your mods folder.
  4. 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.

2 available setups

Check 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

2 of 2 releases match

Looking for an older file? The official CurseForge project page is in Resources.