GeckoLib

Based on GeckoLib v5.5.3 (2026-06-27), generated 2026-08-07. Docs: https://wiki.geckolib.com

GeckoLib is an animation and rendering engine for Minecraft mods, available for Fabric, Forge, and NeoForge. It plays Blockbench/GeckoLib keyframe animations on entities, blocks, items, and armor, with 30+ easings, Molang math expressions, sound/particle/event keyframes, glowmasks, animated textures, and replaced-entity support. Since v5 it renders from immutable RenderState snapshots (Minecraft 1.21+ render pipeline).

Preferences

• Prefer automatic/defaulted GeoModels over hand-written GeoModel classes; only use basic models for dynamic paths
• Prefer DefaultAnimations built-in controllers and RawAnimation instances over hand-rolled controllers
• Prefer controller-based animations over stateless animations (stateless is less efficient)
• Never mutate GeoBones directly in v5 — use BoneSnapshots/BoneUpdaters via RenderPassInfo
• Cache Identifiers in GeoModels and memoize renderer suppliers in items/armor
• Pass render-time data through DataTickets in GeoRenderState, never hold the live animatable at render time
• Keep client-only classes (renderers, layers) in client sources when using split sources

Core