GeckoLib v5.4

变更：

修复：

• 修复了 GeoArmorRenderer 渲染异常的问题
• 修复了在使用 renderlayers 时 GeoArmorRenderer 崩溃的问题
• 修复了动画在已完成的前一个动画基础上继续插值的问题
• 修复了当存在过渡时间时，动画结束无法返回基础姿态的问题
• 修复了默认旋转的骨骼在动画过程中旋转不正确的问题
• 修复了骨骼缩放未生效的问题

API：

• GeoRenderState#addGeckolibData 不再接受 null 值
• 重新添加了 AnimationController 中的 #setTransitionTicks 方法
• 添加了 JsonUtil#jsonToVec3 直接辅助方法
• 开始构建基于 SPI 的 .json 反序列化管道，以实现更安全、更可扩展的模型与动画加载
  • 默认情况下，GeckoLib 将继续使用 GSON 反序列化为中间的未烘焙对象
    • 我正考虑开发一个 GeckoLib 附加组件，使用更快的库（可能是 FastJson？）来加速资源加载，可能带来显著性能提升
  • 该系统尚未完全实现，但大部分代码已经编写并审查完毕，确保其符合当前 Bedrock 几何体与动画规范（分别为 1.21.0 和 1.8.0）
  • 理论上这将允许模组作者创建自己的适配器，用于自定义加载或处理，同时不牺牲安全性
• 移除了未使用且不必要的 GeckoLibClient#getGeoModelForItem，请改用 RenderUtil#getGeckoLibItemRenderer 并按需获取模型
• 将 GeckoLibServices.Client 提取为 GeckoLibClientServices，因为 Java 无故编译失败
• 创建了 GeoBone#positionAndRender，用于实现指定骨骼的完整渲染操作
• 为 GeoRenderState#getOrDefaultGeckolibData 添加了基于 supplier 的回退重载，支持延迟计算
• 添加了 SerializableDataTicket#enforceValidTicket

内部：

• 将 GeckoLib 的空值注解迁移至 JSpecify 规范
  • 你会在库中发现大量增加的空值标注和空值处理，有助于消除对代码状态的困惑
• 进一步清理了 Javadoc
• 添加了大量额外文档——特别是 package-info 文件和参数类型描述
• 将 RawAnimation#additionalTicks 重命名为 RawAnimation#waitTicks
• 从骨骼格式中移除了 bind_pose_rotation 的旧版支持
• 移除了未使用的 AnimationVariables 类
• 将 GeoObjectRenderer 的关联对象泛型类型从 E 改为 O，以与其他部分保持一致
• 将 BoneSnapshots、PerBoneRender 和 RenderPassInfo 移至渲染器基础包
• 将各种内置的 GeoRenderLayer 类移至 builtin 子包
• 将 GeckoLib 的 GSON 实例从 KeyFramesAdapter 移至 GeckoLibResources
• 将 KeyFramesAdapter 重命名为 KeyFrameMarkersAdapter
• 在整个库中清理并标准化了空值处理
• 更新了一些更新前遗留的过时 Javadoc