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 厚度了！