AzureLib 是一个用于 Minecraft 模组的动画与渲染引擎。它最初是 GeckoLib 4.x 的一个分支,随后已发展成为一个独立的库,拥有重写的渲染管线、扩展的 Molang 运行时、逐骨骼碰撞盒、程序化动画工具以及专属的 Blockbench 插件。如果你在某个整合包中见过某种生物爬行、扑击、破土而出或挥舞出具有真实重量的武器,那么很有可能是 AzureLib 在为其提供动画支持。
玩家: 你不需要对这个模组进行任何操作。如果你使用的某个模组需要它,安装即可。
功能特性
动画
- 来自 Blockbench 的关键帧动画:支持对实体、物品、盔甲和方块实体的任意骨骼进行旋转、位移和缩放。
- 30+ 种缓动函数及逐关键帧插值。

缓动可视化由 noisecrime 提供 - 同时使用多个控制器:可以同时运行行走循环、攻击动作和头部注视,且互不冲突。
- 声音、粒子与自定义事件关键帧:在动画的精确时刻触发特效和你的自定义代码。
- Molang 支持向基岩版看齐:支持字符串、数组、
for_each、this以及众多额外的实体查询。
程序化与游戏性工具
- 多碰撞盒系统:为跟随动画模型移动的骨骼定义碰撞盒,这样长尾巴或钻地 worm 就能在其实际位置被击中。

- 骨骼变换与程序化姿态 API:基于关键帧动画之上通过代码驱动骨骼,包括反向运动学 (IK) 和骨骼约束、弹簧骨骼次级运动、骨骼插槽/附件,以及 1D/2D 混合空间。

- 与 Morph 模组兼容:支持 Walkers 和 ReMorphed,使变形后的玩家能够播放你的生物的动画。
性能优化
- 减少动画管线中的逐帧分配和对象池开销。
- 针对长动画采用二分查找关键帧。
- 可选的骨骼与动画 LOD(细节层次)以保持拥挤场景的流畅度(按渲染器单独启用)。
工具链
- AzureLib Blockbench 插件:导出内容与该库完全匹配,包括将 IK 烘焙到关键帧中。
- 示例模组:展示实体、物品、盔甲和方块实体的端到端完整工作流程。
使用 AzureLib 制作的模组
以下是一些使用 AzureLib 的模组(更多请查看画廊标签页):
- Arachnids
- Aftershock
- JCRAFT: Eyes of Ender (JoJo)
- Legends: Superheroes Unlimited
- Discerning The Eldritch
- Celestial Exploration
- Helios Divinity
在你的模组中使用 AzureLib?请在 Discord 上告知我,我会将其添加到此列表中。
支持的版本
| Minecraft | Loaders | AzureLib |
|---|---|---|
| 26.3 | NeoForge / Fabric | 4.1.x |
| 1.21.1 | NeoForge / Fabric | 3.2.x |
| 1.20.1 | Forge / Fabric | 3.2.x |
| 1.18.2 | Forge / Fabric | 3.3.x |
| 1.12.2 | Forge | 1.1.x |
| 1.7.10 | Forge | 1.1.x |
| Beta 1.7.3 | Babric / Ornithe | 1.1.x |
面向开发者
每个加载器的完整设置指南,以及关于实体、物品、盔甲和方块实体的教程和从 GeckoLib 迁移的说明,请参阅 AzureLib wiki。
支持: AzureLib 由个人独立维护。欢迎在 Discord 或 问题追踪器 上提问和报告 bug,但我只提供关于 AzureLib 的支持,不提供 GeckoLib 的支持。
需要和朋友一起玩的服务端?从 BisectHosting 租用即开即用的服务器吧!

选择一个套餐(4GB 或以上),并使用代码 azuredoom 享受首月 25% 的折扣。
AzureLib is an animation and rendering engine for Minecraft mods. It started as a fork of GeckoLib 4.x and has since grown into its own library, with a reworked rendering pipeline, an extended Molang runtime, per-bone hitboxes, procedural animation tools and its own Blockbench plugin. If you've seen a creature in a modpack that crawls, lunges, bursts out of the ground or swings a weapon with real weight, there's a good chance AzureLib is animating it.
Players: you don't need to do anything with this mod. Install it if a mod you use requires it.
Features
Animation
- Keyframe animation from Blockbench: rotation, position and scale on any bone, for entities, items, armor and block entities.
- 30+ easing functions plus per-keyframe interpolation.

Easing visualization by noisecrime - Multiple controllers at once: run a walk cycle, an attack and a head-look together without them fighting each other.
- Sound, particle and custom event keyframes: trigger effects and your own code at exact moments in an animation.
- Molang support extended toward Bedrock parity: strings, arrays,
for_each,this, and many additional entity queries.
Procedural & Gameplay Tools
- Multi-hitbox system: define hitboxes per bone that follow your animated model, so a long tail or a burrowing worm can be hit where it actually is.

- Bone transform & procedural pose API: drive bones from code on top of keyframed animation, including IK and bone constraints, spring-bone secondary motion, bone sockets/attachments, and 1D/2D blend spaces.

- Morph mod compatibility with Walkers and ReMorphed, so morphed players play your mob's animations.
Performance
- Reduced per-frame allocations and object pooling in the animation pipeline.
- Binary-search keyframe lookup for long animations.
- Optional bone and animation LOD to keep crowded scenes smooth (opt-in per renderer).
Tooling
- AzureLib Blockbench plugin with exports matched to the library, including baking IK into keyframes.
- Examples mod showing entities, items, armor and block entities working end to end.
Made with AzureLib
A few of the mods using AzureLib (see the Gallery tab for more):
- Arachnids
- Aftershock
- JCRAFT: Eyes of Ender (JoJo)
- Legends: Superheroes Unlimited
- Discerning The Eldritch
- Celestial Exploration
- Helios Divinity
Using AzureLib in your mod? Let me know on Discord and I'll add it here.
Supported Versions
| Minecraft | Loaders | AzureLib |
|---|---|---|
| 26.3 | NeoForge / Fabric | 4.1.x |
| 1.21.1 | NeoForge / Fabric | 3.2.x |
| 1.20.1 | Forge / Fabric | 3.2.x |
| 1.18.2 | Forge / Fabric | 3.3.x |
| 1.12.2 | Forge | 1.1.x |
| 1.7.10 | Forge | 1.1.x |
| Beta 1.7.3 | Babric / Ornithe | 1.1.x |
For Developers
Full setup for each loader, plus guides for entities, items, armor and block entities and migrating from GeckoLib, is on the AzureLib wiki.
Support: AzureLib is maintained independently. Questions and bug reports are welcome on Discord or the issue tracker, but I can only help with AzureLib, not GeckoLib.
Need a server to play with friends? Rent a ready-to-go server from BisectHosting!

Pick a plan (4GB or more) and use code azuredoom for 25% off your first month.
下载 AzureLib
下载 AzureLib
下载 AzureLib
下载 AzureLib
下载 AzureLib
下载 AzureLib
下载 AzureLib
下载 AzureLib
下载 AzureLib
下载 AzureLib
v3.2.9
新增内容
- 无
修复内容
- 修复了 JEG 针对 Azurelib 箱子破坏原版命中盒的补丁。
变更内容
- 无
开发者备注
- 无
v4.1.8
新增内容
- 添加了简易 API(
AzSimple),这是一种面向初学者的可选方案,仅需一个渲染器类即可实现实体、物品和方块实体的动画效果,无需使用动画师、控制器或调度器。模型、纹理和动画路径均通过名称查找,待机/行走/死亡及自定义when状态会自动播放,同时可通过AzSimple.play、loop和stop从服务端或客户端代码触发动画。被触发的动画支持优先级、中断策略以及保留最后一帧,额外图层支持骨骼遮罩、叠加混合、权重、淡入淡出及条件判断。 - 添加了由动画作者设定的姿态修饰器权重。动画的
pose_weights可为其正在播放的可动画实体的 IK、注视、弹簧及骨骼限制修饰器的姿态层权重进行设置或关键帧处理,并在 Tick 级时间内实现淡入/淡出;当动画停止时,这些权重会恢复为默认值。需要 AzureLib Animator 2.4.0 或以上版本。
修复内容
- 无
更改内容
- 无
开发者备注
- 由动画作者设定的姿态权重会在每个 AzAnimationController 的状态机更新后立即应用。固定权重仅在动画开始时调用一次 AzPoseLayer#fadeWeight,以便代码仍可对其进行修改;而权重轨道会在播放期间每帧调用 setWeight。
v4.1.7
新增内容
- 添加了 Blockbench 多边形网格渲染功能。骨骼内的网格会随骨骼一起渲染和动画,如同方块一样。需要 AzureLib Animator 2.4.0。
- 添加了带平滑变形的蒙皮网格。Blockbench 骨架内的网格使用线性混合蒙皮(每个顶点最多四个权重)跟随骨架的骨骼弯曲,与 Blockbench 预览一致。骨架骨骼导出为普通骨骼,因此动画、程序化姿势、IK、插槽和碰撞盒均可对其生效。
- 来自其他工具的 Bedrock
poly_mesh几何体现在可以加载并渲染,包括混合三角形和四边形的多边形以及tri_list/quad_list简写形式。 - 贴合骨骼几何体的骨骼碰撞盒现在包含刚性网格。
修复
- 修复了
poly_mesh几何体无法加载的问题。位置、法线和 UV 被读取为扁平数组,且不同角数的多边形会导致多边形数组溢出。
更改
- 无
开发者说明
PolyMesh现在将positions、normals和uvs读取为double[][],PolysUnion.union()现在为int[][][],每个条目对应一个多边形的角点([position, normal, uv])。Bone新增了skinnedMeshes组件,从骨骼的azurelib:skinned_meshes列表中读取。- 添加了
AzBakedModelFactory#constructMesh和#constructSkinnedMesh。它们有默认实现,因此自定义工厂只需在constructBone中调用它们即可。 AzBone拥有getMeshes()、getSkinnedMeshes()和getSkinBindings()。皮肤绑定按AzBakedModel实例解析,因此深度复制的模型会使用其自身的骨骼进行蒙皮。- 网格通过
AzModelRenderer#renderCubesOfBone进行渲染,经过新的可重写方法renderMesh和renderSkinnedMesh。调用renderCubesOfBone的渲染器会自动获得网格支持,四边形过滤器和每骨骼纹理覆盖同样适用于网格。
v4.1.4
新增内容
- 添加了弹簧骨骼碰撞体。
AzSpringCollider是一个附着在骨骼上的球体或胶囊体,其位置基于 Blockbench 像素坐标从骨骼的枢轴点偏移,并跟随骨骼的动画姿态移动。弹簧链条无法穿过这些碰撞体,因此尾巴、耳朵和披风会绕着身体摆动,而不是穿过身体。多个链条可以共享同一个碰撞体。 - 添加了
AzSpringBone.Builder#collider用于为链条指定碰撞体,#radius用于设置链条的粗细,以及#ground用于保持链条位于实体脚部上方(对于物品和方块实体则为模型原点上方)。
修复
- 无
更改
- 弹簧骨骼链条现在具备弯曲和甩动效果。每个关节都会向其相对于前一个关节的动画目标位置回弹,导致延迟累积至链条末端;此前,每个关节的延迟角度相同,链条像一根刚性的整体一样摆动。
开发者说明
- 由于每个关节现在都跟随其父关节运动,相同的刚度会使链条卷曲程度比之前更大。针对旧行为调优的链条可能需要更高的刚度:
0.3到0.5的值适合用于尾巴。 - 碰撞解决发生在链条的关节处。如果碰撞体的厚度小于两个关节之间的距离,它可能会从关节之间滑过,因此请确保碰撞体至少具有该厚度,或添加一些
radius值。 - 设置了
radius后,链条会保持在地面之上并远离其他碰撞体,但可能会部分陷入自身厚度的范围内。 - 如果骨骼并不存在于模型中,则该骨骼上的碰撞体会被跳过。不要将碰撞体放置在链条自身的骨骼上,或与链条的动画姿态重叠的位置,否则链条会一直被推出且无法稳定下来。
v1.1.3
已移至 GTNH 构建脚本,由于映射名称更改,Maven 需要重新构建。
v1.1.2
新增内容
- 序列阶段现在可以设置自己的动画速度、过渡长度、缓动函数、起始偏移量、冻结点和重复次数。这些设置仅在该阶段播放时生效,之后不再对控制器产生持久影响。
- 为中途冻结的阶段添加了
AzSequence#freeze(name, tick)。 - 添加了基于阶段的序列事件:
eventAt(name, keyframeTick)、eventOnStart(name)和eventOnEnd(name)。它们遵循播放速度、过渡、起始偏移量、重复次数和阶段长度,而不是固定的游戏刻数。 - 添加了
AzSequenceTiming和AzSequenceTimeline用于计算阶段和事件的发生时间,以及AzSequencePlayer#withTiming和AzAnimationController#sequenceTiming()(客户端侧,从动画文件中读取长度)。 - Molang:表达式中任意位置的赋值、多个以
;分隔的语句、{}代码块、return、loop(count, body)、break和continue。 - Molang:二元条件运算符 (
a ? b)、空值合并运算符 (??)、短路逻辑与/或 (&&/||),以及true/false。 - Molang:
variable.*/v.*的值现在按可动画对象存储,因此每个实体、方块实体或物品都保留自己的副本。代码可以通过AzAnimationContext#molangScope()读取和写入这些值。
修复
- 修复了骨骼碰撞盒(以及其他骨骼矩阵使用者)在实体具有重新渲染模型的渲染层时忽略渲染器的
setScale的问题。在没有缩放属性的版本上,碰撞盒现在随模型一起缩放。 - 修复了在控制器上设置冻结点后动画卡住的问题(例如通过完整的
AzCommand.create重载方法)。冻结点现在仅适用于FREEZE_ON_FRAME类型的动画,因此后续的循环、乒乓播放和序列阶段正常播放。 - 修复了当冻结点短于过渡长度时,导致过渡永远保持打开状态的问题。
- 修复了在过渡期间改变方向会跳过混合并直接跳转到新动画的问题。
- 修复了当冻结点来自动画文件时,
FREEZE_ON_FRAME在第一帧暂停的问题。 - 修复了
REPEAT_X_TIMES多播放一次并忽略动画文件中编写的repeat_times的问题。 - 修复了起始刻偏移量被乘以动画速度并缩短过渡的问题。现在过渡会向实际开始播放的姿态进行混合。
- Molang:
pi和e现在解析为其对应的常数,而不是 0。 - Molang:修复了并行解析动画文件时可能出现的竞态条件。
变更
- 减少日志噪音:待处理的动画调度产生的“Replaying queued command(s)”消息现在仅在开发环境中显示。
REPEAT_X_TIMES现在总共精确播放repeatXTimes次,与其文档描述一致。针对旧行为调整的动画将少重复一次。- Molang 表达式现在由新的解析器编译。无法处理的内容将回退到旧解析器并重试,并记录警告信息("Falling back to the legacy parser")。
- Molang:
temp.*/t.*的值现在在每次评估时重置,而不是在实体之间保留。 - Molang:尝试赋值给
query.*、context.*、math.*或常量现在会被拒绝并记录日志,且表达式的求值结果为 0。
开发者说明
- 使用
event(name, tick)添加的序列事件保持其原有含义(play()之后的游戏刻数)。 - 基于阶段的事件依赖于其所依赖的动画长度。在服务器端,请通过
AzSequenceTiming.builder().length(name, ticks)传递它们。无法确定时间的 events 将被跳过,并仅发出一次警告,而不是提前触发。 - 通过
MolangParser#register、setValue或setMemoizedValue从代码驱动的全局变量仍然有效:只要可动画对象未分配自己的值,动画就会读取这些全局变量。 AzQueuedAnimation新增了stageProperties组件;现有的构造函数保持不变。
v4.1.1
新增内容
- 无
修复内容
- 修复了 Molang 变量赋值错误地将右侧表达式读取为赋值目标的问题,导致 v. 和 t. 变量无法正确赋值。
变更内容
- 无
开发者备注
- 无
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧