Fabric 1.19.2
on 2026 Apr 253.1.20
- 更改为 Parchment MC 映射。
- 添加了修复,希望能解决 Arch/Multiloader 项目的问题。
- 代码清理。
- 添加了新的循环系统框架,目前尚不支持在最后一帧保持,但框架已就位 —— DerToaster98
Forge 1.16.5
on 2026 Apr 25v3.0.92
- 更改为 Parchment MC 映射。
- 代码清理
- 回溯移植了壁虎栖息地
- 添加了全新循环系统的基础,目前尚不支持在最后一帧保持,但框架已就位 — DerToaster98
Quilt 1.19.2
on 2026 Apr 253.1.19
- 更新核心以支持所有当前的Molang函数
Fabric 1.19.2
on 2026 Apr 253.1.19
- 更新了 Core 以支持所有当前的 Molang 函数
Forge 1.16.5
on 2026 Apr 25v3.0.91
- 代码清理
Quilt 1.19.2
on 2026 Apr 253.1.18
- 优化了栖息地放置检查与正确放置逻辑。
- 代码清理。
- 更多导入已迁移至 Quilt 版本,而非 Fabric 版本。
Fabric 1.19.2
on 2026 Apr 253.1.18
- 优化了栖息地放置检测与正确放置逻辑。
- 代码清理
Forge 1.16.5
on 2026 Apr 25v3.0.90
- 代码清理
Quilt 1.19.2
on 2026 Apr 253.1.17
- 修复了盔甲的扩展实体渲染问题 - DerToaster
Forge 1.16.5
on 2026 Apr 25v3.0.89
- 修复了盔甲的扩展实体渲染问题 - DerToaster
Fabric 1.19.2
on 2026 Apr 253.1.16
- 修复了关闭 HUD 时 NameTag 的渲染问题。 - legenden#7526
Fabric 1.16.5
on 2026 Apr 25v3.0.88
- 修复了关闭HUD时名称标签的渲染问题。 - legenden#7526
Fabric 1.19.2
on 2026 Apr 253.1.15
- 更新至最新版 Fabric API。
Fabric 1.16.5
on 2026 Apr 25v3.0.87
- 修正盔甲在 ExtendedRenderEntities 上的正确缩放 —— DerToaster
- 修正 GeoRenderEntities 上骨骼的正确隐藏 —— DerToaster
NeoForge 26.1.2-5.5.1
on 2026 Apr 12GeckoLib v5.5.1
变更
API
- 添加了
CustomBoneTextureGeoLayer#shouldRenderBone,以支持处理自定义隐藏的骨骼
问题修复
- 修复了
query.limb_swing未正确插值的问题(#834)
Fabric 26.1.2-5.5.1
on 2026 Apr 12GeckoLib v5.5.1
变更
API
- 添加了
CustomBoneTextureGeoLayer#shouldRenderBone,以支持处理自定义隐藏的骨骼
Bug 修复
- 修复了
query.limb_swing插值不正确的问题(#834)
NeoForge 26.1-5.5
on 2026 Mar 24GeckoLib v5.5
- 移植到 26.1
变更
API
- 将 GeckoLib 的基础包从
software.bernie.geckolib重构为com.geckolib - 添加了
GeoLocator- 一种用于定位器的对象实现。它们仅用于监听渲染位置- 添加了
BakedGeoModel#getLocator和BakedGeoModel#locators - 添加了
GeoBone#locators - 添加了
RenderPassUtil#addLocatorPositionListener - 将
GeoBone#updateBonePositionListeners提取为RenderUtil#providePositionsToListeners
- 添加了
- 修改了 GeckoLib 的资源加载方式,以允许完全自定义的资源格式
- 提供对
Resource实例的根级访问。编写一个适配器,即可从你想要的任何格式中读取资源文件! - 将
GeckoLibLoader从 SPI 改为可注册接口 - 添加了
GeckoLibUtil#addResourceLoader - 移除了
GeckoLibUtil#addCustomBakedModelFactory - 将
BakedGeoModel转换为非 record、可扩展的类,以便潜在的第三方适配器使用 - 将
Animation转换为非 record、可扩展的类,以便潜在的第三方适配器使用 - 将
ModelProperties转换为非 record、可扩展的类,以便潜在的第三方适配器使用 - 将
MathParser改回可实例化对象,以支持可扩展实现,并为其添加了去重方案,同时进行了整体清理 - 改进了
MathParser的去重方案,进一步降低内存占用 - 移除了
BakedAnimationsAdapter和KeyFrameMarkersAdapter - 移除了旧版加载对象:
BoneCubeFaceUVLocatorClassLocatorValueMinecraftGeometryModelPolyMeshPolysUnionTextureMeshUVFacesUVUnionBoneStructureGeometryTree- 将
ModelProperties移动到geckolib.cache.model - 将
BakedAnimations移动到geckolib.cache.animation
- 提供对
- 清理了
EasingType- 为
EasingType和GeckoLibUtil添加了无参数工厂构造器 - 添加了
EasingState#interpolate - 添加了
EasingState#getFirstEasingArg - 添加了
EasingType#modifyKeyframes - 将
EasingType#register改为返回泛型类型,而不是EasingType - 移除了
EasingType#easeIn - 移除了
EasingType#lerpWithOverride - 移除了
EasingType#fromJson
- 为
- 添加了
BakedAnimationCache#size和BakedModelCache#size - 为
BakedGeoModel的ModelProperties添加了.json资源路径 - 移除了
GeoReplacedEntity#getReplacingEntityType,因为它已不再使用 - 将所有 Javadocs 转换为 Markdown 格式
- 折叠了
BakedGeoModel和GeoBone中的内部实现方法,以优化 API 可见性 - 移除了基于 TokenType 的
DataTickets的类参数,并正确为内置 GeckoLib tickets 添加了类型 - 移除了
MiscUtil#WORLD_TO_MODEL_SIZE - 移除了
MiscUtil#MODEL_TO_WORLD_SIZE - 添加了
JsonUtil#worldToModelUnits和JsonUtil#modelToWorldUnits - 从以下类中移除了渲染状态的双类型泛型:
DirectionalProjectileRendererDyeableGeoArmorRendererGeoArmorRendererGeoBlockRendererGeoEntityRendererGeoReplacedEntityRenderer
- 将
ModelFormatVersion移动到com.geckolib.loading.definition.geometry.object - 将
Rotation重命名为UvFaceRotation,并移动到com.geckolib.loading.definition.geometry.object - 由于已不再使用,移除了
DefaultedEntityGeoModel中的headBone及其相关构造器 - 为
DefaultedBlockGeoModel、DefaultedEntityGeoModel和DefaultedItemGeoModel添加了直接对象构造器 - 移除了
GeckoLibPlatform#getGameDir,因为它已不再使用 - 移除了
SerializableDataTickets。自 1.21.x 早期版本以来,它们在 GeckoLib 中就已经没有位置了,而且始终存在无法解决的实现问题。 - 添加了
VanillaModelModifier- 这主要是一个内部实现类,用来弥补原版实现留下的空缺 - 修复并重新启用了
ItemArmorGeoLayer,并为非Equippable物品添加了支持 GeoRenderer#performRenderPass现在在开始渲染通道时支持多个预制BoneUpdaters- 按照 Minecraft 标准,将渲染中的一些
BlockState和ItemStack引用转换为ItemStackRenderState和BlockModelRenderState- 原版尚未建立能让这套系统无处不在的完整机制,所以我只是尽可能在能做的地方做了
- 添加了
RenderUtil#createRenderStateForItem - 添加了
RenderUtil#createRenderStateForBlock
- 添加了
DataTickets#create,作为创建 DataTickets 的快捷/辅助方法 - 将
DataTicket.GLOW_COLOUR更改为DataTicket.OUTLINE_COLOR - 将
DataTicket.BLOCK_FACING移动到GeoBlockRenderer.DIRECTION_FACING - 将
DataTicket.ITEM移动到GeoItemRenderer.CURRENT_ITEM - 将
DataTicket.EQUIPMENT_SLOT移动到GeoArmorRenderer.CURRENT_SLOT - 将
DataTicket.IS_GECKOLIB_WEARER移动到GeoArmorRenderer.IS_GECKOLIB_WEARER - 将
DataTicket.HUMANOID_MODEL移动到GeoArmorRenderer.BASE_MODEL - 在
GeoBlockRenderer的构造器中添加了BlockEntityRendererProvider.Context
其他
- 将
1.16.0和1.19.30添加到已知的几何模型定义中 - 提升了资源加载性能
- 为
BlockEntityRenderState->GeoRenderState添加了接口注入 - GeckoLib 在无法找到模型时将不再崩溃;取而代之的是渲染一个缺失材质的立方体
Bug 修复
- 修复了
RenderUtil#transformToBone以反向顺序运行的问题 - 修复了
AnimationController使用了错误 InternalApi 注解的问题 - 修复了顶层骨骼不总是向
BonePositionListeners提供正确位置的问题 - 修复了 GeckoLib 模型骨骼在嵌套于父骨骼下时不按正确顺序渲染的问题
- 修复了 GeckoLib 模型加载未正确遵循
mirror和inflate值的问题 - 减少了 0 深度立方体背面的 z-fighting。别再把你的立方体做成 0 厚度了!
Fabric 26.1-5.5
on 2026 Mar 24GeckoLib v5.5
- 移植到 26.1
变更
API
- 将 GeckoLib 的基础包从
software.bernie.geckolib重构为com.geckolib - 添加了
GeoLocator—— 用于定位器的对象实现。它们仅用于监听渲染位置- 添加了
BakedGeoModel#getLocator和BakedGeoModel#locators - 添加了
GeoBone#locators - 添加了
RenderPassUtil#addLocatorPositionListener - 将
GeoBone#updateBonePositionListeners提取为RenderUtil#providePositionsToListeners
- 添加了
- 修改了 GeckoLib 的资源加载方式,以支持完全自定义的资源格式
- 提供对
Resource实例的根级访问。你可以编写一个适配器,从任意你想要的格式中读取资源文件! - 将
GeckoLibLoader从 SPI 改为可注册接口 - 添加了
GeckoLibUtil#addResourceLoader - 移除了
GeckoLibUtil#addCustomBakedModelFactory - 将
BakedGeoModel转换为非 record、可继承的类,以支持潜在的第三方适配器 - 将
Animation转换为非 record、可继承的类,以支持潜在的第三方适配器 - 将
ModelProperties转换为非 record、可继承的类,以支持潜在的第三方适配器 - 将
MathParser改回可实例化对象,以支持可扩展实现,并为其添加了去重方案,同时进行了整体清理 - 改进了
MathParser的去重方案,进一步降低了内存占用 - 移除了
BakedAnimationsAdapter和KeyFrameMarkersAdapter - 移除了旧版加载对象:
BoneCubeFaceUVLocatorClassLocatorValueMinecraftGeometryModelPolyMeshPolysUnionTextureMeshUVFacesUVUnionBoneStructureGeometryTree- 将
ModelProperties移动到geckolib.cache.model - 将
BakedAnimations移动到geckolib.cache.animation
- 提供对
- 清理了
EasingType- 为
EasingType和GeckoLibUtil添加了无参数工厂构造方法 - 添加了
EasingState#interpolate - 添加了
EasingState#getFirstEasingArg - 添加了
EasingType#modifyKeyframes - 将
EasingType#register的返回类型改为泛型,而不是EasingType - 移除了
EasingType#easeIn - 移除了
EasingType#lerpWithOverride - 移除了
EasingType#fromJson
- 为
- 添加了
BakedAnimationCache#size和BakedModelCache#size - 为
BakedGeoModel的ModelProperties添加了.json资源路径 - 移除了
GeoReplacedEntity#getReplacingEntityType,因为它已不再使用 - 将所有 Javadocs 转换为 Markdown 格式
- 为了 API 可见性,折叠了
BakedGeoModel和GeoBone中的内部实现方法 - 移除了基于 TokenType 的
DataTickets的类参数,并为 GeckoLib 内置 tickets 正确添加了类型 - 移除了
MiscUtil#WORLD_TO_MODEL_SIZE - 移除了
MiscUtil#MODEL_TO_WORLD_SIZE - 添加了
JsonUtil#worldToModelUnits和JsonUtil#modelToWorldUnits - 从以下类中移除了渲染状态的双类型泛型:
DirectionalProjectileRendererDyeableGeoArmorRendererGeoArmorRendererGeoBlockRendererGeoEntityRendererGeoReplacedEntityRenderer
- 将
ModelFormatVersion移动到com.geckolib.loading.definition.geometry.object - 将
Rotation重命名为UvFaceRotation,并移动到com.geckolib.loading.definition.geometry.object - 由于已不再使用,移除了
DefaultedEntityGeoModel中的headBone及其相关构造器 - 为
DefaultedBlockGeoModel、DefaultedEntityGeoModel和DefaultedItemGeoModel添加了直接对象构造器 - 移除了
GeckoLibPlatform#getGameDir,因为它已不再使用 - 移除了
SerializableDataTickets。自 1.21.x 早期版本以来,它们在 GeckoLib 中就已经没有合适的位置,而且始终存在无法解决的实现问题。 - 添加了
VanillaModelModifier—— 这主要是一个内部实现类,用于弥补原版实现留下的空缺 - 修复并重新启用了
ItemArmorGeoLayer,并添加了对非Equippable物品的支持 GeoRenderer#performRenderPass现在在开始渲染通道时支持多个预制BoneUpdaters- 根据 Minecraft 标准,将渲染中的部分
BlockState和ItemStack引用转换为ItemStackRenderState和BlockModelRenderState- 原版目前还没有把这些系统全面铺开,所以我只能先在能做的地方进行处理
- 添加了
RenderUtil#createRenderStateForItem - 添加了
RenderUtil#createRenderStateForBlock
- 添加了
DataTickets#create,作为创建 DataTickets 的快捷/辅助方法 - 将
DataTicket.GLOW_COLOUR改为DataTicket.OUTLINE_COLOR - 将
DataTicket.BLOCK_FACING移动到GeoBlockRenderer.DIRECTION_FACING - 将
DataTicket.ITEM移动到GeoItemRenderer.CURRENT_ITEM - 将
DataTicket.EQUIPMENT_SLOT移动到GeoArmorRenderer.CURRENT_SLOT - 将
DataTicket.IS_GECKOLIB_WEARER移动到GeoArmorRenderer.IS_GECKOLIB_WEARER - 将
DataTicket.HUMANOID_MODEL移动到GeoArmorRenderer.BASE_MODEL - 在
GeoBlockRenderer的构造器中添加了BlockEntityRendererProvider.Context
其他
- 将
1.16.0和1.19.30添加到已知几何模型定义中 - 提升了资源加载性能
- 为
BlockEntityRenderState->GeoRenderState添加了接口注入 - 当无法找到模型时,GeckoLib 将不再崩溃;取而代之的是渲染一个缺失材质的立方体
Bug 修复
- 修复了
RenderUtil#transformToBone以反向顺序运行的问题 - 修复了
AnimationController使用了错误的 InternalApi 注解的问题 - 修复了顶级骨骼并不总是能向
BonePositionListeners提供正确位置的问题 - 修复了 GeckoLib 模型骨骼在嵌套于父骨骼下时未按正确顺序渲染的问题
- 修复了 GeckoLib 模型加载未正确遵循
mirror和inflate值的问题 - 减少了 0 深度立方体背面的 z-fighting。别再把你的立方体做成 0 厚度了!
NeoForge 1.21.11-5.4.5
on 2026 Mar 03GeckoLib v5.4.5
错误修复
- 修复了动画在结束时有时会过渡到自身的问题
- 修复了 CustomBoneTextureGeoLayer 未在正确位置渲染的问题
- 修复了 MathParser 未能正确解析组内负数的问题
Forge 1.21.11-5.4.5
on 2026 Mar 03GeckoLib v5.4.5
修复的错误
- 修复了动画在结束时有时会过渡到自身的问题
- 修复了 CustomBoneTextureGeoLayer 未在正确位置渲染的问题
- 修复了 MathParser 未能正确解析组内负数的问题




