Forge 1.20.4
on 2026 Apr 25v4.4
- 重新加入先前移除的优化，该优化曾用于处理动画冲突。启用此优化的效果优于不启用
- 在 GeoEntity 渲染中添加
isShaking方法，与原版 LivingEntityRenderer#isShaking 保持一致 - 改进了 GeoEntity 的 shouldShowName 实现，使其更好地匹配原版现代化的实现方式，支持队伍及其他条件
NeoForge 1.20.1
on 2026 Apr 25Forge 1.20.2
on 2026 Apr 25v4.3.1
- 将 ItemArmorGeoLayer#getModelForItem 中的空参数替换为实际参数
NeoForge 1.20.1
on 2026 Apr 25v4.3
- 将 GeoReplacedEntityRenderer#shouldShowName 改为使用传入的实体参数，而非缓存的实体实例，以更好地兼容 entityculling
- 完全移除失败的优化，因其与着色器存在似乎无法修复的不兼容问题
- 新增 GeoRenderer#getPackedOverlay 方法并加入 partialTick 参数，弃用现有方法以备后续移除
- 新增 DyeableGeoArmorRenderer —— 一个专为 GeckoLib 护甲模型设计的原生可染色护甲渲染器
Forge 1.20.2
on 2026 Apr 25v4.3
- 将 GeoReplacedEntityRenderer#shouldShowName 改为使用提供的实体参数，而非缓存的实体实例，以更好地兼容 entityculling
- 因与着色器存在看似无法修复的不兼容问题，彻底移除失败的优化
- 新增 GeoRenderer#getPackedOverlay 方法（支持 partialTick），并弃用现有方法以待移除
- 新增 DyeableGeoArmorRenderer —— 专为 GeckoLib 护甲模型设计的原生可染色护甲渲染器
NeoForge 1.20.1
on 2026 Apr 25v4.2.4
- 将 fabric.mod.json 中的 Fabric API ID 更改为使用较新的 'fabric-api' ID
- 禁用了在 4.2 版本早期加入的动画计算优化。由于着色器存在太多边缘情况，目前保留该优化并不现实
- 修复了一个当场景中存在多个带动画纹理的对象时导致其显示异常的 Bug。遗憾的是，这要求带动画的纹理无法再为每个对象设置独立的播放时间 =/
- 修复了更多与着色器和 OptiFine 的兼容性问题
Forge 1.20.1
on 2026 Apr 25v4.2.4
- 将 fabric.mod.json 中的 Fabric API ID 更改为使用较新的 'fabric-api' ID
- 关闭了在 4.2 版本早期加入的动画计算优化。由于着色器存在太多边缘情况，目前保留该优化并不现实
- 修复了一个当场景中存在多个带动画纹理的对象时导致其显示异常的 Bug。不幸的是，这要求带动画的纹理无法再为每个对象单独设置不同的播放时长 =/
- 修复了更多与着色器和 OptiFine 的兼容性问题
Forge 1.20.2
on 2026 Apr 25v4.2.3
- 修复了安装光影时，GeoArmor 在光标附近渲染异常的问题
- 修复了带有渲染层的 GeoItem 其渲染层出现莫名偏移的问题
- 可能修复了安装 Optifine 时光滑表面反射失效的问题
- 新增对 Bedrock 动画格式的额外解析支持
Fabric 1.20.2
on 2026 Apr 25v4.2.3
- 修复了安装光影时，GeoArmor 在光标附近渲染的问题
- 修复了带有渲染层的 GeoItem 其渲染层出现莫名偏移的问题
- 可能修复了安装 Optifine 后反光表面失效的问题
- 新增对 Bedrock 动画格式的额外解析支持
Forge 1.20.1
on 2026 Apr 25v4.2.3
- 修复了安装光影时，光标附近的 GeoArmor 渲染问题
- 修复了带有渲染层的 GeoItem 其渲染层出现莫名偏移的问题
- 可能修复了安装 Optifine 后反光表面失效的问题
- 新增对更多基岩版动画格式的解析支持
Forge 1.20.1
on 2026 Apr 25- 修复了一些 Javadoc 错误
- 修复了 GeoEntityRenderer 在 renderRecursively 中传递硬编码值作为 isReRender 参数的问题
- 修复了玩偶匣示例中损坏的 ogg 文件
- 因与前任维护者存在纠纷，移除了手枪示例
- 进一步优化了渲染和动画处理，以减少不必要的工作
- 修复了在非人形实体上使用时宝石护甲无法正确对齐的问题
- 将壁虎栖息地示例物品转换为实际的栖息地
Fabric 1.20.1
on 2026 Apr 25修复方块实体的旧版翻译
修复多个非生物几何实体之间的动画冲突
修复 GeoReplacedEntityRenderer 未能正确保存世界空间矩阵平移的问题
有望修复在控制器中于异常时机设置动画时偶尔引发的崩溃
为 GUI 中的几何物品渲染添加替代光照方案选项
Forge 1.19.4
on 2026 Apr 25v4.2
- 新增 AnimationState#isCurrentAnimationStage 辅助方法
- 新增 AnimationState#resetCurrentAnimation 辅助方法
- 新增 AnimationState#setControllerSpeed 辅助方法
- 新增 AnimationController#transitionLength 方法，功能等同于 AnimationController#setTransitionLength，但采用工厂模式。原方法已标记为弃用，后续将移除
- 若在同一渲染帧中对同一动画对象进行二次渲染，则避免重复执行动画处理流程
- 为核心模块添加 JetBrains 注解
- 在 GeoAnimatable 中新增 AnimatableCache 覆盖实现
- 新增支持上下文感知的动画对象实现，可为不同上下文独立处理动画（实验性功能）
- 为所有 geo 对象新增动画纹理支持
Forge 1.19.4
on 2026 Apr 25v4.1.3
- 修复 GeoBones 的局部/模型/世界坐标位置无效的问题
- 新增 RenderLayersContainer，以支持 Forge 的延迟 CompileLayersEvent
- 为 GeoRender 添加 renderFinal 方法，允许在 PoseStack 操作之外执行渲染操作
- 修复缩放生物的拴绳与命名牌渲染问题
- 修复 GeoGlowLayer 颜色显示错误的问题
- 修复示例手枪物品中 PistolRenderer 的错误实现
- 修复婴儿生物的 GeoArmor 模型渲染异常的问题
Fabric 1.19.4
on 2026 Apr 25v4.1.3
- 修复 GeoBones 的本地/模型/世界坐标失效的问题
- 新增 RenderLayersContainer，以支持 Forge 延迟触发 CompileLayersEvent
- 为 GeoRender 添加 renderFinal 方法，允许在姿态矩阵操作之外执行渲染操作
- 修复缩放生物的拴绳结与名牌渲染问题
- 修复 GeoGlowLayer 的错误着色
- 修复示例手枪物品中 PistolRenderer 的错误实现
- 修复小小怪物的 GeoArmor 模型渲染异常
Forge 1.19.4
on 2026 Apr 25v4.1.2
- 修复了因参数错位导致的拴绳渲染不正确的问题。
- 新增 scaleModelForRender 方法用于缩放模型，应能解决大部分缩放问题。
Quilt 1.19.4
on 2026 Apr 25v4.1.2
- 修复了因参数错位导致的拴绳渲染异常问题。
- 新增 scaleModelForRender 方法用于缩放模型，应能解决大部分缩放相关的问题。
Forge 1.19.3
on 2026 Apr 25v4.0.6
- 修复了因参数错位导致的拴绳渲染不正确的问题。
- 新增 scaleModelForRender 方法用于缩放模型，应能解决大部分模型缩放问题。
Quilt 1.19.3
on 2026 Apr 25v4.0.6
- 修复了因参数错位导致的拴绳渲染错误。
- 新增 scaleModelForRender 用于缩放模型，应能解决大部分缩放问题。
Forge 1.19.4
on 2026 Apr 25v4.1.1
- 修复了拴绳渲染时缓冲区未重置的问题。
对库进行了完全重写。所有变更请参阅 https://github.com/bernie-g/geckolib/wiki/Geckolib-4-Changes