NeoForge 1.21.8
on 2026 Apr 25GeckoLib v5.2.2
问题修复
- 修复了 AnimationProcessor 中错误信息的一处拼写错误
- 修复了 GeoModel 中对后备资源位置的错误处理
内部调整
- 优化了 GeoArmorRenderer 的虚拟 ID 查找逻辑,以提升微性能
Forge 1.21.8
on 2026 Apr 25GeckoLib v5.2.2
修复的错误
- 修复了 AnimationProcessor 中错误信息的一个拼写错误
- 修复了 GeoModel 中对后备位置的错误处理
内部调整
- 调整了 GeoArmorRenderer 的虚拟 ID 查找逻辑,以提升微性能
NeoForge 1.21.7
on 2026 Apr 25GeckoLib v5.2.1
移植至 1.21.7
错误修复
- 临时修复实体物品渲染不可见的问题。可能需要进行破坏性变更才能彻底解决,很快就会有结果
Forge 1.21.7
on 2026 Apr 25GeckoLib v5.2.1
移植至 1.21.7
错误修复
- 临时修复 Entity Item 渲染不可见的问题。可能需要进行破坏性更改才能彻底解决,具体情况将很快确认
NeoForge 1.21.6
on 2026 Apr 25GeckoLib v5.2.0
破坏性变更 - 抱歉!
新增内容
- GeoItemRenderer 的渲染对象已从 ItemStack 更改为 GeoItemRenderer$RenderData。
- 这意味着 GeoItemRenderer 现在可以访问一些额外的上下文对象,包括持有该物品的玩家。
问题修复
- 修复了 GeoItem 在
AnimationTest阶段无法使用ItemRenderContext的问题(#735)
Forge 1.21.6
on 2026 Apr 25GeckoLib v5.2.0
破坏性变更 - 抱歉!
新增内容
- GeoItemRenderer 的渲染对象已从 ItemStack 更改为 GeoItemRenderer$RenderData。
- 这意味着 GeoItemRenderer 现在可以访问一些额外的上下文对象,包括持有该物品的玩家。
问题修复
- 修复了在
AnimationTest阶段 GeoItem 无法获取ItemRenderContext的问题 (#735)
NeoForge 1.21.1
on 2026 Apr 25v4.7.6
- 清理 GeckoLibUtil#getSyncedAnimatable 的 Javadoc 和参数命名
- 允许手动更改的 GeckoLib 物品堆叠 ID(???)能像普通情况一样同步
- 修复 GeoArmorRenderer 在未注册为同步动画实体时共享其动画的问题(#730)
Forge 1.21.1
on 2026 Apr 25v4.7.6
- 清理 GeckoLibUtil#getSyncedAnimatable 的 Javadoc 和参数命名
- 允许手动更改的 GeckoLib 堆栈 ID(???)像往常一样同步
- 修复 GeoArmorRenderer 在未注册为同步动画对象时共享其动画的问题 (#730)
NeoForge 1.21.5
on 2026 Apr 25GeckoLib v5.1.0
新增内容
- 新增
AutoGlowingGeoLayer#shouldAddZOffset—— 一个开关,用于提升对特定渲染类型或特殊情况的兼容性 - 新增
AutoGlowingGeoLayer#getBrightness—— 一个可配置值,用于调整自发光层的亮度
更改内容
- 在
AutoGlowingGeoLayer#shouldRespectWorldLighting方法参数中添加了 RenderState - 少量代码清理
问题修复
- 修复 GeoArmorRenderer 不支持 Glowmasks 的问题。此修复需要小幅重写,会造成轻微破坏性变更,敬请谅解。
- 修复当 GeoArmorRenderer 未注册为可同步的 GeoAnimatable 时,在多个穿戴实例间共享动画的问题(#730)
Forge 1.21.5
on 2026 Apr 25GeckoLib v5.1.0
新增内容
- 新增
AutoGlowingGeoLayer#shouldAddZOffset—— 用于提升对特定渲染类型或特殊情形的兼容性 - 新增
AutoGlowingGeoLayer#getBrightness—— 可配置值,用于调整自发光层的亮度
变更内容
- 在
AutoGlowingGeoLayer#shouldRespectWorldLighting方法参数中添加了 RenderState - 小幅代码清理
修复内容
- 修复 GeoArmorRenderer 不支持发光遮罩的问题。需小幅重写,略有破坏性变更,敬请谅解。
- 修复当未注册为可同步的 GeoAnimatable 时,GeoArmorRenderer 在穿戴实例间共享动画的问题(#730)
NeoForge 1.21.4
on 2026 Apr 25v4.8.5
- 修复 stopTriggeredSingletonAnim 实际上启动了触发动画而非停止它
Forge 1.21.4
on 2026 Apr 25v4.8.5
- 修复 stopTriggeredSingletonAnim 实际上启动了一个触发动画而非停止它的问题
NeoForge 1.21.5
on 2026 Apr 25GeckoLib v5.0.2
修复的错误
- 修复了 stopTriggeredSingletonAnim 实际上会启动一个触发动画而非停止它的问题
Forge 1.21.5
on 2026 Apr 25GeckoLib v5.0.2
修复的错误
- 修复了 stopTriggeredSingletonAnim 实际上会启动一个触发动画,而非停止它的问题
Forge 1.20.1
on 2026 Apr 25v4.7.1.3
Fabric:
- 更新 MixinItemRenderer 以提升第三方模组的兼容性
NeoForge 1.21.5
on 2026 Apr 25GeckoLib v5.0.1
修复的错误
- 修复了 AutoGlowingGeoLayer 渲染出黑色和紫色模型的问题
Forge 1.21.5
on 2026 Apr 25GeckoLib v5.0.1
修复的漏洞
- 修复了 AutoGlowingGeoLayer 渲染出黑色和紫色模型的问题
NeoForge 1.21.5
on 2026 Apr 25GeckoLib v5.0
新增内容
- 新增
ItemInHandGeoLayer - 新增
PerBoneRender - 新增
DataTickets#IS_LEFT_HANDED - 新增
DataTickets#IS_CROUCHING - 新增
GeoRender#adjustPositionForRender - 新增
DirectionalProjectileRenderer - 新增
TextureLayerGeoLayer - 新增
CustomBoneTextureGeoLayer
内部变更
- 移除了在加载无后缀的动画或模型文件时产生的一些不必要的警告
- 修复了
DefaultedGeoModel中使用旧格式的 Javadoc - 将缩放属性处理移入
GeoEntityRenderer的scaleModelForRender方法中,并调整了睡眠姿势的位移以更好地适配缩放 - 将
scaleModelForRender从preRender中移出,改为独立调用 - 优化了
RenderUtil#getTextureDimensions,并使其能够考虑加载后的修改 - 优化了
BakedGeoModel#getBone
API 变更
- 移除了
GeoRenderer#applyRenderLayersForBone。现在逐骨骼渲染在#preApplyRenderLayers中添加 - 新增
GeoRenderLayer#addPerBoneRender - 修改了
ItemArmorGeoLayer的实现方式,使其更高效,并支持鞘翅(尽管目前尚未完全正确) - 修改了
BlockAndItemGeoLayer的实现方式,使其更高效且代码更清晰 - 将
ItemArmorGeoLayer#prepModelPartForRender重命名为prepHumanoidModelForRender - 将
GeckoLibClient#getArmorModelForItem的返回类型从基础Model改为HumanoidModel,因为非人形模型从未被使用过 - 在
GeoRenderer#renderFinal中新增了packedLight、packedOverlay和renderColor参数 - 移除了
GeoEntityRenderer#calculateYRot中的final修饰符 - 移除了
BoneFilterGeoLayer和FastBoneFilterGeoLayer
问题修复
- 修复了
GeckoLibAnimatedTexture在纹理加载失败时崩溃的问题 - 修复了逐骨骼渲染任务干扰查询值的问题
- 修复了渲染层中的 PoseStack 操作干扰骨骼位置获取的问题
- 修复了
GeoItemRenderer和GeoObjectRenderer在缩放时定位错误的问题 - 修复了
GeoReplacedEntityRenderer未正确传递 PoseStack 操作的问题 - 修复了
ItemArmorGeoLayer与其他使用相同 DataTicket 的图层发生冲突的问题
Forge 1.21.5
on 2026 Apr 25GeckoLib v5.0
新增内容
- 新增
ItemInHandGeoLayer - 新增
PerBoneRender - 新增
DataTickets#IS_LEFT_HANDED - 新增
DataTickets#IS_CROUCHING - 新增
GeoRender#adjustPositionForRender - 新增
DirectionalProjectileRenderer - 新增
TextureLayerGeoLayer - 新增
CustomBoneTextureGeoLayer
内部变更
- 移除了在加载无后缀的动画或模型文件时产生的一些不必要的警告
- 修正了
DefaultedGeoModel中使用旧格式的 Javadoc - 将缩放属性处理移入
GeoEntityRenderer的scaleModelForRender方法中,并调整了睡眠姿态的位移以更好地适配缩放 - 将
scaleModelForRender从preRender中移出,改为独立调用 - 优化了
RenderUtil#getTextureDimensions,并使其能够处理加载后的修改 - 优化了
BakedGeoModel#getBone
API 变更
- 移除了
GeoRenderer#applyRenderLayersForBone。现在逐骨骼渲染在#preApplyRenderLayers中添加 - 新增
GeoRenderLayer#addPerBoneRender - 修改了
ItemArmorGeoLayer的实现方式,使其更高效,并支持鞘翅(尽管目前尚未完全正确) - 修改了
BlockAndItemGeoLayer的实现方式,使其更高效且代码更清晰 - 将
ItemArmorGeoLayer#prepModelPartForRender重命名为prepHumanoidModelForRender - 将
GeckoLibClient#getArmorModelForItem的返回类型由基础Model改为HumanoidModel,因为非人形模型从未被使用 - 在
GeoRenderer#renderFinal中新增了packedLight、packedOverlay和renderColor参数 - 移除了
GeoEntityRenderer#calculateYRot的final修饰符 - 移除了
BoneFilterGeoLayer和FastBoneFilterGeoLayer
问题修复
- 修复了
GeckoLibAnimatedTexture在纹理加载失败时崩溃的问题 - 修复了逐骨骼渲染任务干扰查询值的问题
- 修复了渲染层中的 PoseStack 操作干扰骨骼位置获取的问题
- 修复了
GeoItemRenderer和GeoObjectRenderer在缩放时定位不正确的问题 - 修复了
GeoReplacedEntityRenderer未正确传递 PoseStack 操作的问题 - 修复了
ItemArmorGeoLayer与其他使用相同 DataTicket 的图层发生冲突的问题
NeoForge 1.21.5
on 2026 Apr 25GeckoLib v5.0-alpha2
注意
- 仍在探索每根骨骼渲染处理的替代方案,因为Mojang已使先前的动态渲染器变得不切实际。
修复内容
- 修复了 GeoObjectRenderer 未存储打包光照的问题(#712)
- 修复了 GeoEntityRenderer 不允许通用扩展 RenderStates 的问题
- 修复了
AutoGlowingGeoLayer中部分错误的 Javadoc 注释 - 修复了 GeoArmorRenderer 未考虑发光或隐身 DataTickets 的问题
- 重载纹理会导致发光与动画纹理出现异常问题
内部变更
- AutoGlowingGeoLayer 不再移除基础纹理的部分区域,从而支持选择性动态发光
- AutoGlowingGeoLayer 不再禁用着色器兼容性
- 动画纹理与发光遮罩(glowmask)不再相互依赖。你现在可以在动画纹理上使用非动画的发光遮罩,反之亦然。
新增内容
- 新增了
RenderUtil#getEmissiveResource辅助方法 - AutoGlowingGeoLayer 现在包含
shouldRespectWorldLighting方法,允许你在绝对发光与结合世界光照进行明暗变化的发光之间进行选择
移除内容
- GeckoLib 的发光纹理不再支持 mcmeta 文件创建。请改用发光遮罩图像(反正也简单得多)



