3.1.18

• 优化了栖息地放置检测与正确放置逻辑。
• 代码清理

v3.0.90

• 代码清理

3.1.17

• 修复了盔甲的扩展实体渲染问题 - DerToaster

v3.0.89

• 修复了盔甲的扩展实体渲染问题 - DerToaster

3.1.16

• 修复了关闭 HUD 时 NameTag 的渲染问题。 - legenden#7526

v3.0.88

• 修复了关闭HUD时名称标签的渲染问题。 - legenden#7526

3.1.15

• 更新至最新版 Fabric API。

v3.0.87

• 修正盔甲在 ExtendedRenderEntities 上的正确缩放 —— DerToaster
• 修正 GeoRenderEntities 上骨骼的正确隐藏 —— DerToaster

GeckoLib v5.5.1

变更

API

• 添加了 CustomBoneTextureGeoLayer#shouldRenderBone，以支持处理自定义隐藏的骨骼

问题修复

• 修复了 query.limb_swing 未正确插值的问题（#834）

GeckoLib v5.5.1

变更

API

• 添加了 CustomBoneTextureGeoLayer#shouldRenderBone，以支持处理自定义隐藏的骨骼

Bug 修复

• 修复了 query.limb_swing 插值不正确的问题（#834）

GeckoLib 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
  • 移除了旧版加载对象：
    • Bone
    • Cube
    • FaceUV
    • LocatorClass
    • LocatorValue
    • MinecraftGeometry
    • Model
    • PolyMesh
    • PolysUnion
    • TextureMesh
    • UVFaces
    • UVUnion
    • BoneStructure
    • GeometryTree
    • 将 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
• 从以下类中移除了渲染状态的双类型泛型：
  • DirectionalProjectileRenderer
  • DyeableGeoArmorRenderer
  • GeoArmorRenderer
  • GeoBlockRenderer
  • GeoEntityRenderer
  • GeoReplacedEntityRenderer
• 将 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 厚度了！

GeckoLib 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
  • 移除了旧版加载对象：
    • Bone
    • Cube
    • FaceUV
    • LocatorClass
    • LocatorValue
    • MinecraftGeometry
    • Model
    • PolyMesh
    • PolysUnion
    • TextureMesh
    • UVFaces
    • UVUnion
    • BoneStructure
    • GeometryTree
    • 将 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
• 从以下类中移除了渲染状态的双类型泛型：
  • DirectionalProjectileRenderer
  • DyeableGeoArmorRenderer
  • GeoArmorRenderer
  • GeoBlockRenderer
  • GeoEntityRenderer
  • GeoReplacedEntityRenderer
• 将 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 厚度了！

GeckoLib v5.4.5

错误修复

• 修复了动画在结束时有时会过渡到自身的问题
• 修复了 CustomBoneTextureGeoLayer 未在正确位置渲染的问题
• 修复了 MathParser 未能正确解析组内负数的问题

GeckoLib v5.4.5

修复的错误

• 修复了动画在结束时有时会过渡到自身的问题
• 修复了 CustomBoneTextureGeoLayer 未在正确位置渲染的问题
• 修复了 MathParser 未能正确解析组内负数的问题

GeckoLib v5.4.5

修复的错误

• 修复了动画在结束时有时会过渡到自身的问题
• 修复了 CustomBoneTextureGeoLayer 渲染位置不正确的问题
• 修复了 MathParser 无法正确解析组内负数的问题

GeckoLib v5.4.4

更改

API

• 新增 RenderPassInfo#getPreRenderMatrixPose 与 RenderPassInfo#getModelRenderMatrixPose，用于捕获完整的 PoseStack 姿态，而不仅限于矩阵姿态本身
• 新增 OverridingDataTicket —— 一种 DataTicket 实现，优先使用已存在的 RenderState 字段值，再应用自身逻辑
  • 此机制可捕获那些在渲染器提取后、由原版或其他模组修改的 RenderState 字段值（修复 #818）

错误修复

• 修复循环动画有时导致实体消失的问题
• 修复 GeckoLib 在关键帧键为空字符串时无法加载动画的问题
• 修复 RenderUtil#transformToBone 对 PoseStack 执行反向操作的问题（#819）
• 修复 RenderUtil#transformToBone 未考虑回退至支点位置的问题（#822）
• 修复 MathParser 有时错误解析数学表达式的问题（#820）
• 修复未注册为同步动画实体的 GeoItem 有时发生 ID 冲突的问题
• 修复在极特定情况下某些动画偶尔重复播放最后几帧的问题

GeckoLib v5.4.4

更改

API

• 新增 RenderPassInfo#getPreRenderMatrixPose 与 RenderPassInfo#getModelRenderMatrixPose，用于捕获完整的 PoseStack 姿态，而不仅限于矩阵姿态本身
• 新增 OverridingDataTicket —— 一种 DataTicket 实现，优先使用已存在的 RenderState 字段值，再应用自身逻辑
  • 此机制可捕获那些在渲染器提取后被原版或其他模组修改的 RenderState 字段值（修复 #818）

问题修复

• 修复了循环动画有时导致实体消失的问题
• 修复了 GeckoLib 在关键帧键为空字符串时无法加载动画的问题
• 修复了 RenderUtil#transformToBone 对 PoseStack 的操作顺序颠倒的问题（#819）
• 修复了 RenderUtil#transformToBone 未考虑回退至支点位置的问题（#822）
• 修复了 MathParser 有时错误解析数学表达式的问题（#820）
• 修复了未注册为同步可动画物品的 GeoItem 有时发生 ID 冲突的问题
• 修复了在极特定情况下某些动画偶尔重复播放最后几帧的问题

GeckoLib v5.4.4

更改

API

• 新增 RenderPassInfo#getPreRenderMatrixPose 与 RenderPassInfo#getModelRenderMatrixPose，用于捕获完整的 PoseStack 姿态，而不仅限于矩阵姿态本身
• 新增 OverridingDataTicket —— 一种 DataTicket 实现，优先使用已存在的 RenderState 字段值，再应用自身逻辑
  • 此机制可捕获那些在渲染器提取后、由原版或其他模组修改的 RenderState 字段值（修复 #818）

Bug 修复

• 修复循环动画有时导致实体消失的问题
• 修复 GeckoLib 在关键帧键为空字符串时无法加载动画的问题
• 修复 RenderUtil#transformToBone 对 PoseStack 执行反向操作的问题（#819）
• 修复 RenderUtil#transformToBone 未考虑回退至支点位置的问题（#822）
• 修复 MathParser 有时错误解析数学表达式的问题（#820）
• 修复未注册为同步动画实体的 GeoItem 有时发生 ID 冲突的问题
• 修复某些动画在极特定情况下偶尔重复播放最后几帧的问题

GeckoLib v5.4.3

新增内容

• 新增 RenderUtil#prepMatrixForBoneAndUpdateListeners
• 新增 RenderUtil#addPosToMatrix

错误修复

• 修复骨骼位置监听器未能获取正确位置的问题

GeckoLib v5.4.3

新增内容

• 新增 RenderUtil#prepMatrixForBoneAndUpdateListeners
• 新增 RenderUtil#addPosToMatrix

错误修复

• 修复骨骼位置监听器未获取正确位置的问题