Agent skill · hairyf

geckolib

GeckoLib Minecraft mod animation — GeckoLib 5 (1.21+) render-state pipeline plus GeckoLib 4.4.9 (1.20.1) API for Fabric/Forge/NeoForge: setup, entities, blocks, items, armor, replaced entities, animation controllers, Molang, render layers, textures, and data syncing. Use when working with GeckoLib animatables, .geo.json/.animation.json assets, or adding keyframe animations to a Minecraft mod.

What it needs

About 4k tokens when loaded.

What this skill does

GeckoLib Based on GeckoLib v5.5.3 (2026-06-27) and GeckoLib v4.4.9 (2024-08-30, MC 1.20.1), generated 2026-08-07, v4 content added 2026-08-08. Docs: https://wiki.geckolib.com (v5) + the GeckoLib 4 wiki (v4). 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); v4 (up to 4.4.9 for MC 1.20.1) renders directly from the animatable under the software.bernie.geckolib package with geo/ + animations/ asset folders. 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 Topic Description Reference ------- ------------- ----------- Setup Maven repo + dependency per loader, Blockbench plugin, asset file placement core-setup Animatable Pattern AnimatableInstanceCache, registerControllers, per-type interfaces core-animatable-interface GeoModels Automatic, Defaulted, and Basic models; v5 path rules core-geomodels Animation Controllers StateHandler/AnimationTest, PlayState, ordering, additive, DefaultAnimations core-animation-controller Keyframes & Molang AnimationPoint/Timeline, Molang operators, fun …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills hairyf/geckolib

View the source on GitHub

Browse the @skills marketplace