AzureLib Mod (1.21.1, 1.20.1) – Advanced Animation Support

AzureLib is a library and animation engine mod that enables Minecraft mod developers to create custom 3D models and animations for items, blocks, and entities using Bedrock model formats, available for Fabric, Forge, NeoForge, and Quilt loaders.

Quick Answer: AzureLib is a developer library — you don't install it on its own for gameplay changes. Install it only if another mod you want to use lists AzureLib as a required dependency.

If you've ever installed a Minecraft mod that features beautifully animated mobs, weapons with custom attack animations, or blocks with moving parts, there's a good chance AzureLib was working behind the scenes to make it happen. Originally forked from Geckolib 4.x, AzureLib has grown into one of the most widely used animation libraries in the Minecraft modding ecosystem, surpassing 8 million downloads on Modrinth alone. Maintained by AzureDoom, this library solves a fundamental problem for mod creators: Minecraft's vanilla animation system is extremely limited, and without a dedicated engine like AzureLib, developers would have to write complex animation code from scratch for every single mod. For players, that means more mods with smoother, more impressive visuals — all powered by this one lightweight dependency.

Key Features of AzureLib

  • 3D Keyframe-Driven Animations — AzureLib supports intricate 3D keyframe animations built using the Bedrock model format, which means mod developers can design complex movement sequences in tools like Blockbench and import them directly. For players, this translates to mobs that move fluidly, weapons with satisfying swing arcs, and blocks with mechanical animations that feel polished rather than stiff.
  • Over 30 Easing Functions — Easing functions control how animations accelerate and decelerate, and AzureLib ships with more than 30 built-in options. This gives developers fine-grained control over animation feel — whether a creature's walk cycle needs a bouncy spring or a heavy, weighted stomp, the right easing function makes it look natural.
  • Concurrent Animation Support — Rather than limiting entities to one animation at a time, AzureLib allows multiple animations to play simultaneously. A modded boss mob can swing its arms, flap its wings, and glow with energy effects all at once, creating far more dynamic and visually engaging encounters.
  • Sound and Particle Keyframes — Developers can tie sound effects and particle emissions directly to specific frames within an animation. This means a dragon's fire breath can sync perfectly with a roar sound and flame particles, rather than relying on approximate timing that often feels slightly off.
  • Event-Based Keyframes — Beyond visuals and audio, AzureLib supports event keyframes that can trigger custom game logic at precise moments during an animation. A modded sword could apply a damage effect exactly when the blade visually connects, making combat feel responsive and well-timed.
  • Multi-Loader Compatibility — AzureLib runs on Fabric, Forge, NeoForge, and Quilt, covering virtually every popular mod loader in the ecosystem. Mod developers can build once and support all major platforms, and players don't need to worry about loader-specific incompatibilities.
  • Active Maintenance and Bedrock Model Support — As a fork that has moved beyond Geckolib, AzureLib receives dedicated updates and bug fixes from AzureDoom. The library leverages Minecraft's Bedrock model format, which is well-documented and supported by popular modeling tools like Blockbench, lowering the barrier for new mod creators.

Screenshots

AzureLib Mod (1.21.1) Screenshot
AzureLib Mod (1.21.1) Screenshot

How to Install AzureLib

  1. Install a compatible mod loader for your Minecraft version: Fabric, Forge, NeoForge, or Quilt.
  2. Download the correct AzureLib version for your Minecraft version and mod loader from the official download sources linked below.
  3. Place the downloaded AzureLib .jar file into your .minecraft/mods folder. If the folder does not exist, create it manually.
  4. Launch Minecraft using your chosen mod loader profile and confirm AzureLib appears in your mod list.
  5. Install any content mods that depend on AzureLib — the library itself does not add visible gameplay changes on its own.

Requirements & Compatibility

Minecraft Version Supported Loaders
1.21.1 Fabric, Quilt, NeoForge
1.20.1 Forge, NeoForge, Fabric, Quilt
1.19.2 Forge, Fabric, Quilt
1.18.2 Forge, Fabric, Quilt

What's New

  • Version 3.1.4 includes a fix for a mixin conflict with Gankolib animated textures, resolving crashes and rendering issues when both libraries were loaded together.
  • AzureLib continues to receive regular updates, with the most recent release dated March 2026.
  • The library is licensed under MIT, making it freely available for any mod developer to use and modify.

Pros and Cons

Pros

  • Supports all four major mod loaders: Fabric, Forge, NeoForge, and Quilt
  • Over 8 million downloads — widely trusted and battle-tested across hundreds of mods
  • Rich animation feature set including concurrent animations, sound keyframes, and 30+ easing functions
  • MIT licensed and open source with an active maintainer
  • Uses the well-supported Bedrock model format compatible with Blockbench

Cons

  • Adds no visible content on its own — purely a developer dependency
  • Players must match the exact AzureLib version to the mod that requires it, which can cause version mismatch errors
  • Forked from Geckolib, so mods built specifically for Geckolib are not compatible without developer changes
  • Documentation may require some technical knowledge to navigate for less experienced mod developers

Alternatives to AzureLib

  • GeckoLib — The original animation library that AzureLib forked from, still maintained separately and used by many popular mods for entity, item, and block animations.
  • PlayerAnimator — A library focused specifically on custom player animations, useful for mods that need to add new movement styles, emotes, or combat animations to the player model.
  • Architectury API — A cross-platform modding abstraction layer that helps developers write code compatible with multiple loaders, often used alongside animation libraries like AzureLib.

Download AzureLib

Minecraft Version Fabric Forge NeoForge Quilt
For Minecraft 1.21.1 Download Download Download
For Minecraft 1.20.1 Download Download Download Download
For Minecraft 1.19.2 Download Download Download
For Minecraft 1.18.2 Download Download Download

Always download mods from official sources to stay safe.

Frequently Asked Questions

Is AzureLib the same as GeckoLib?

No — AzureLib is a separate fork originally derived from GeckoLib 4.x. While they share historical roots, AzureLib is independently maintained by AzureDoom and has diverged in features and compatibility. Mods built for GeckoLib will not automatically work with AzureLib, and vice versa. If a mod lists AzureLib as a dependency, you need to install AzureLib specifically.

Do I need AzureLib if I just play Minecraft and don't make mods?

Yes, but only if a mod you want to use requires it. AzureLib is a library mod, meaning it provides code that other mods depend on. If you see AzureLib listed in a mod's requirements, you must install it for that mod to function properly. On its own, AzureLib does not add any gameplay content.

Does AzureLib work with Minecraft 1.21.1?

Yes — AzureLib supports Minecraft 1.21.1 on Fabric, Quilt, and NeoForge loaders. Forge support for 1.21.1 is not listed in the current release, so Forge users should check for updates or use NeoForge instead. Earlier versions including 1.20.1, 1.19.2, and 1.18.2 are also supported.

Will AzureLib affect my game performance?

AzureLib appears to be lightweight as a standalone library, since it only processes animations when mods actively use it. The actual performance impact depends on how many AzureLib-powered mods you have installed and how many animated entities are on screen simultaneously. For most players with a reasonable mod count, the library itself should not cause noticeable frame drops.

Can I use AzureLib and GeckoLib together in the same modpack?

Yes, in most cases both libraries can coexist because they occupy separate namespaces. Some mods require AzureLib while others require GeckoLib, and having both installed allows each mod to load its own dependency. However, version 3.1.4 specifically fixed a mixin conflict with Gankolib animated textures, so always use the latest version to avoid potential rendering conflicts.

Looking for more? Browse all Minecraft Mods on McInside.

Explore Minecraft Mods →

Click to rate this post!
[Total: 8 Average: 4.1]