Forge 1.21.1
on 2026 Apr 25v4.7.3
- 修复了实体速度主要由 x 坐标速度决定的问题
getTextureResource和getModelResource现在会接收到渲染器，以支持上下文相关的变体
NeoForge 1.21.1
on 2026 Apr 25Forge 1.21.1
on 2026 Apr 25v4.7.2
- 修复单例动画的“停止”触发动作实际上并未停止的问题
NeoForge 1.21.4
on 2026 Apr 25v4.8
- 更新至 1.21.4
- 修复加载发光遮罩（glowmasks）时可能导致 InputStream 卡住的问题
- 修复 Geo 动画纹理未正确支持自定义帧时间（frametimes）的问题
- GeckoLib 现在需要一个位于
assets/modid/item的 JSON 文件，以声明其渲染方式为特殊类型。
我们将在未来研究简化此流程的方法，示例见：
https://github.com/bernie-g/geckolib-examples/tree/Multiloader-1.21.4/common/src/main/resources/assets/examplemod/items
Forge 1.21.4
on 2026 Apr 25v4.8
- 更新至 1.21.4
- 修复加载发光遮罩（glowmasks）时可能导致 InputStream 卡住的问题
- 修复 Geo 动画纹理未正确支持自定义帧时间（frametimes）的问题
- GeckoLib 现在需要一个位于
assets/modid/item的 JSON 文件，以声明其渲染方式为特殊类型。
未来将研究简化此流程的方法，示例见：
https://github.com/bernie-g/geckolib-examples/tree/Multiloader-1.21.4/common/src/main/resources/assets/examplemod/items
NeoForge 1.21.3
on 2026 Apr 25v4.7.1
- 为 DeferredGeoRenderProvider 中的部分方法添加了缺失的注解
- 修复了 GeoBlockEntity 注释中的多余字母
- 修复了 StopTriggeredAnim 数据包未注册的问题
- 修复了 AutoGlowingGeoLayer 渲染错误颜色的问题
- 修复了 ItemArmorGeoRenderer 未能正确渲染装备部件的问题
Forge 1.21.3
on 2026 Apr 25v4.7.1
- 为 DeferredGeoRenderProvider 中的方法添加了一些缺失的注解
- 修复了 GeoBlockEntity 注释中的多余字母
- 修复了 StopTriggeredAnim 数据包未注册的问题
- 修复了 AutoGlowingGeoLayer 渲染错误颜色的问题
NeoForge 1.21.3
on 2026 Apr 25v4.7
- ItemArmorGeoLayer 现在能正确渲染原版盔甲的镶边及其他装饰，并支持模组自定义部件可见性。
4.7 版本变更摘要：
- 更新至 1.21.3
- EntityRenderState 已被封装并忽略——目前使用 GeckoLib 时无需关注此项
- 移除了
query.is_poweredMolang 查询，因其已不再具备实际可行性 - 将不支持的 geo 模型格式版本从崩溃改为警告
- 修复了 NeoForge 模组的版本范围错误
- 新增对 UV 面旋转的支持
- 新增延迟加载的 GeoRenderProvider，以支持分离资源源（split-sources）
- 新增触发式动画的停止函数，允许以与最初触发相同的方式停止已触发的动画
- 新增动画回退钩子——现在可在单个 GeoModel 中声明多个动画文件以查找动画（适用于多态/模块化可动画对象）
- GeoModel 的 #getTextureResource 与 #getModelResource 方法现接收渲染器参数，以便根据渲染上下文提供模型与贴图
- 关键帧事件现在会传入 AnimationState，以提供额外上下文信息
- 将 GeoRenderer 中 AnimationState 的创建移至独立方法，便于重写
- 将渲染器的颜色传递给渲染层
- 修复 Color#ofARGB 实际为 RGBA 的问题
- 移除先前已弃用的方法
- 修复部分 Entity 与 ReplacedEntity 的 geo 渲染器问题
- 修复实体速度主要由 x 坐标速度决定的问题
- 修复与控制器无关的触发动画函数无法工作的问题
- 为部分网络功能引入额外的安全措施，防止意外崩溃
- 将带动画的贴图更新移至内部处理器，避免 GeoRenderer 实现类需自行处理
Forge 1.21.3
on 2026 Apr 25v4.7
- ItemArmorGeoLayer 现在能正确渲染盔甲镶边及其他原版盔甲装饰，并支持模组自定义部件可见性
4.7 版本变更摘要：
- 更新至 1.21.3
- EntityRenderState 已被封装并忽略——目前使用 GeckoLib 时无需关心此项
- 移除了
query.is_poweredMolang 查询，因其已不再具备实际可行性 - 将不支持的 geo 模型格式版本由崩溃改为警告
- 修正了 NeoForge 模组的版本范围错误
- 新增对 UV 面旋转的支持
- 新增延迟加载的 GeoRenderProvider，以支持分离资源源（split-sources）
- 新增触发式动画停止函数，允许以与最初触发相同的方式停止触发式动画
- 新增动画回退钩子——现在可在单个 GeoModel 中声明多个动画文件以查找动画（适用于多态/模块化可动画对象）
- GeoModel 的 #getTextureResource 与 #getModelResource 方法现会接收渲染器参数，以便根据渲染上下文提供模型与贴图
- 关键帧事件现在会传入 AnimationState，以提供额外上下文信息
- 将 GeoRenderer 中 AnimationState 的创建移至独立方法，便于重写
- 将渲染器中的渲染颜色传递至渲染层
- 修复 Color#ofARGB 实际为 RGBA 的问题
- 移除先前已弃用的方法
- 修复部分 Entity 与 ReplacedEntity 的 geo 渲染器问题
- 修复实体速度主要由 x 坐标速度决定的问题
- 修复与控制器无关的触发动画函数无法工作的问题
- 为部分网络功能引入额外的安全机制，防止意外崩溃
- 将带动画的贴图更新逻辑移至内部处理器，GeoRenderer 实现不再需要自行处理
NeoForge 1.21.3
on 2026 Apr 25v4.7-beta-2
- 新增对 UV 面旋转的支持
- 新增一个延迟的 GeoRenderProvider，用于支持分离资源（split-sources）
- 新增一个由触发器启动的动画停止函数，允许以与最初触发相同的方式停止已触发的动画
- 为动画添加了后备钩子——现在可以在单个 GeoModel 中声明多个动画文件以查找动画（适用于多态/模块化可动画对象）
- GeoModel 现在在 #getTextureResource 和 #getModelResource 中接收渲染器，以支持依赖渲染上下文的模型和纹理
- 关键帧事件现在会接收到 AnimationState，以提供额外上下文信息
- 将 GeoRenderer 中 AnimationState 的创建移至独立方法，便于轻松重写
- 将渲染器中的渲染颜色传递给渲染层
- 修复 Color#ofARGB 实际上是 RGBA 的问题
- 移除先前已弃用的方法
- 修复了 Entity 和 ReplacedEntity 的 geo 渲染器的一些问题
- 修复实体速度主要由 x 坐标速度决定的问题
- 修复了与控制器无关的触发动画函数无法工作的问题
- 引入额外的安全机制，防止某些网络功能意外崩溃
- 将带动画的纹理更新移至内部处理器，避免 GeoRenderer 实现类需要自行处理
Forge 1.21.3
on 2026 Apr 25v4.7-beta-2
- 新增对UV面旋转的支持
- 新增延迟的GeoRenderProvider，以支持拆分资源
- 新增触发动画停止功能，允许以与最初触发相同的方式停止触发的动画
- 为动画新增回退钩子——现在你可以在单个GeoModel中声明多个动画文件，用于查找动画（适用于多态/模块化可动画对象）
- GeoModel现在在#getTextureResource和#getModelResource中接收渲染器，以支持依赖渲染上下文的模型和纹理
- 关键帧事件现在会接收到AnimationState，提供更多上下文信息
- 将GeoRenderer中的AnimationState创建移至独立方法，便于重写
- 将渲染器的渲染颜色传递给渲染层
- 修复Color#ofARGB实际为RGBA的问题
- 移除先前已弃用的方法
- 修复Entity与ReplacedEntity的geo渲染器部分问题
- 修复实体速度主要由x坐标速度决定的问题
- 修复控制器无关的触发动画函数无效的问题
- 引入额外安全措施，防止某些网络功能意外崩溃
- 将动画纹理计时移至内部处理器，避免GeoRenderer实现需要自行处理
NeoForge 1.21.3
on 2026 Apr 25v4.7-beta-1
- 更新至 1.21.3
- 此为破坏性版本。我发布此版本是为了让依赖 GeckoLib 的模组作者可以开始移植，但后续仍将引入破坏性变更
- EntityRenderState 已被封装并忽略——目前使用 GeckoLib 时无需关注此项
- 移除了
query.is_poweredMolang 查询，因其已不再具备实际可行性 - 将 Geo 模型使用不受支持的模型格式版本时的崩溃改为警告
- 修复了 NeoForge 模组的版本范围错误
Forge 1.21.3
on 2026 Apr 25v4.7-beta-1
- 更新至 1.21.3
- 此为破坏性版本。我发布此版本是为了让依赖 GeckoLib 的模组开发者能够开始移植，但后续仍将引入破坏性变更
- EntityRenderState 已被封装并忽略——目前使用 GeckoLib 时无需关注此项
- 移除了
query.is_poweredMolang 查询，因其已不再具备实际可行性 - 将 geo 模型中不支持的模型格式版本导致的崩溃改为警告
- 修复了 NeoForge 模组的版本范围错误
NeoForge 1.21.1
on 2026 Apr 25v4.6.6
- 修复与 Neoforge 21.1.62 的不兼容问题。修复了 #634
- GeckoLib 现在可以渲染任意可穿戴物品，而不仅限于 ArmorItem，从而在盔甲渲染方面提供更高的灵活性
- GeoArmorRenderer 现在会捕获额外的渲染上下文数据以供使用
Forge 1.21.1
on 2026 Apr 25v4.6.6
- 修复与 Neoforge 21.1.62 的不兼容问题。修复了 #634
- GeckoLib 现在可以渲染任意可穿戴物品，而不仅限于盔甲类物品，从而在盔甲渲染方面提供更高的灵活性
- GeoArmorRenderer 现在会捕获额外的渲染上下文数据以供使用
NeoForge 1.21.1
on 2026 Apr 25Forge 1.21.1
on 2026 Apr 25v4.6.5
- 修复了 SingletonGeoAnimatables 的类名查找错误。修复了 #632
NeoForge 1.21.1
on 2026 Apr 25Forge 1.21.1
on 2026 Apr 25v4.6.4
- 修复了一些损坏的单例网络调用。修复了 #631
NeoForge 1.21.1
on 2026 Apr 25v4.6.3
- 添加了渲染后清理功能，以消除内存泄漏并降低整体内存占用
- 新增了一些与模型 FormatVersion 相关的错误日志信息