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