GeckoLib v5.3-alpha-2

Alpha 2 更新说明：

• 修复在较新版本 Forge 上加载时崩溃的问题 (#773)
• 修复未渲染完整套装时 GeoArmorRenderer 崩溃的问题 (#771)
• BlockAndItemGeoLayer#renderStackForBone 和 #renderBlockForBone 分别重命名为 #submitItemStackRender 和 #submitBlockRender
• 将 OBJECT_RENDER_POSE 和 MODEL_RENDER_POSE DataTickets 移至基础 GeoRenderer，子类无需在覆盖方法中处理它们
• 修复每个 GeoBone 仅处理一个 PerBoneRenderTask 的问题
• 新增 GeoBone#transformToBone
• 将 PerBoneRender 任务拆分至 GeoRenderer#submitPerBoneRenderTasks
• 移除多个 GeoRenderer 方法调用中的 skipPerBoneTasks，因其已不再需要
• 创建 PerBoneRenderTasks 以更清晰地处理日益复杂的逐骨骼渲染任务
• 限制 GeoArmorLayer 的泛型类型必须为 AvatarRenderState，因为这是其模型实际所需的类型
• 新增 RenderStateUtil

变更内容

• 移植至 1.21.10
  • 注意：此为 ALPHA 版本，移除 alpha 标签前可能包含破坏性变更。
  • 大多数 GeoRenderers 不再填充 PACKED_LIGHT DataTicket，因为基础 RenderState 类现已默认包含 lightCoords
  • 新增 GeoRenderState#getPackedLight
  • GeoRenderer#defaultRender 已重命名为 #submitRenderTasks，以更准确反映其当前功能（此时并未实际渲染）
  • GeoRenderer#actuallyRender 已重命名为 #buildRenderTask，以更准确反映其功能
  • GeoLayer#render 已重命名为 #buildRenderTask，以更准确反映其功能
  • 移除 GeoRenderer#reRender。渲染层或渲染器应通过 GeoRenderer#buildRenderTask 提交另一个渲染任务。因此，渲染器方法中不再需要检查 isReRender
  • preRender、scaleModelForRender 和 adjustPositionForRender 均已移至预渲染事件检查之后
  • 新增 GeoRenderer#createRenderState
  • 移除 GeoEntityRenderer#createBaseRenderState —— 请改用 #createRenderState
  • 从默认设置中移除多个 DataTickets（因它们只是现有原版属性的直接复制），以消除多重数据来源并提升性能
  • GeckoLib 渲染器中的多个 Matrix4f 变量已移至 DataTickets
  • 移除 GeoRenderer#doPostRenderCleanup
  • 在 GeoArmorLayer.RenderData 中添加关联的 HumanoidModel
• 重写 GeoArmorRenderer —— 现在应该显著更易于使用和理解
• 修改 DefaultedEntityGeoModel，使其接受自定义骨骼名称而非简单的布尔值
• 在各类 GeoRenderer 中新增 #withRenderLayer，以支持函数式实例化
• GeoObjectRenderer 现在对其 GeoRenderState 使用泛型，允许泛型扩展
• 直接将 partialTick 传递给 GeoRenderer#addRenderData、GeoRenderLayer#addRenderData、GeoModel#prepareForRenderPass 以及各类 CompileRenderState 事件/钩子 (#762)
• 将 GeoRenderer#adjustPositionForRender 重命名为 #adjustRenderPose，以更准确反映其预期用途
• ItemArmorGeoLayer.RenderData 现在使用 GeoArmorRenderer.ArmorSegment 而非手动插槽和部件获取器
• 使 GeoRenderEvent 及其各类子事件兼容多加载器
• 所有平台特定的 GeckoLib 事件现已拆分为独立类，便于查找和管理。例如：CompileBlockRenderLayersEvent

新增内容

• 新增“无状态”动画对象。这是处理 GeckoLib 动画对象动画的另一种方式。
  • 参见：https://github.com/bernie-g/geckolib/wiki/Stateless-Animatable-Handling-(Geckolib5)
  • 新增：
    • StatelessGeoBlockEntity
    • StatelessGeoEntity
    • StatelessGeoObject
    • StatelessGeoReplacedEntity
    • StatelessGeoSingletonAnimatable
    • StatelessAnimationController
• 新增 attack.punch 默认动画常量
• 新增 misc.idle.flying 默认动画常量
• 新增 move.dive 默认动画常量
• 新增 DefaultAnimations#triggerOnlyController，用于创建专门处理任意触发动画的控制器
• 新增 RawAnimation#getStageCount
• 新增 AnimationController#getStateHandler
• 新增 DefaultAnimations#genericWalkFlyIdleController
• 为各类 GeckoLib 渲染器新增构造函数重载，可直接传入物品并使用对象注册 ID 创建默认实例，实现快速便捷处理
  • 例如：new GeoEntityRenderer(ModEntities.MY_ENTITY);
• 新增 GeoRenderEvent#hasData
• 新增 RenderUtil#getReplacedEntityRenderer
• 新增 RenderUtil#getGeckoLibItemRenderer
• 新增 RenderUtil#getGeckoLibEntityRenderer
• 新增 RenderUtil#getGeckoLibBlockRenderer
• 新增 RenderUtil#getGeckoLibArmorRenderer

修复内容

• 添加双深度基岩关键帧解析，因为我完全不知道为什么 Blockbench 会导出这种格式
• 修复多人游戏中其他玩家对全新堆叠物品触发的动画无法正确显示的问题
• 修复 AnimationController 中部分错误的 javadoc
• 确保在传递给 GeoArmorRenderer 进行提取前正确提取 EntityRenderState

内部变更

• 将 GeckoLib 数据包重新组织到文件夹中
• 为 Animation.Stage 新增 StreamCodec 实现
• 为 RawAnimation 新增 StreamCodec 实现
• 为更多内部方法及所有 Mixin 添加 javadoc 以提高清晰度
• 改进 GeoRenderEvent#getRenderData 的 Javadoc
• 移除 RenderUtil#getCurrentSystemTick
• 移除 RenderUtil#booleanToFloat
• 移除 RenderUtil#getGeoModelForEntityType
• 移除 RenderUtil#getGeoModelForEntity
• 移除 RenderUtil#getGeoModelForItem
• 移除 RenderUtil#getGeoModelForBlock
• 移除 RenderUtil#getGeoModelForArmor
• 将 RenderUtil#getCurrentTick 移至 ClientUtil
• 将 RenderUtil#arrayToVec 移至 JsonUtil
• 从 GeoRenderProvider#getGeoArmorRenderer 中移除部分冗余参数
• 将 ItemArmorGeoLayer#prepHumanoidModelForRender 重命名为 #positionModelPartFromBone