GeckoLib Animation Optimizer

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