GeckoLib v5.0-alpha1

注意

• 自 alpha1 起，发光遮罩（glowmasks）和带动画的纹理尚不可用。此问题将很快修复 :)
• 此外，我正在研究骨骼级渲染处理的替代方案，因为 Mojang 已使原先的动态渲染器不再实用。
• 如果你使用了上述任何功能，请等待 5.0 正式版发布，谢谢。

通用变更

• 更新至 Minecraft 1.21.5
• 将更新日志转换为 Markdown 格式

内部变更

• 重写了资源加载系统，以正确支持并行化资源处理，避免过度占用 I/O
• 使 GeoArmorRenderer 从 HumanoidArmorLayer#setPartVisibility 继承骨骼可见性，以更好地兼容第三方模组
• 默认将 boneResetTime 设为 5 游戏刻，并在重置时间设为 0 时自动完成重置。这可防止不可避免的部分游戏刻骨骼重置
• 修复了对同步动画物品中键点击时，在使用触发动画或同步数据时产生冲突的问题 (#681)
• 现在使用动画进行完整旋转的骨骼在重置时不再反向旋转，从而使旋转动画更流畅
• 同步动画物品现在彼此之间可以正常堆叠
• 为动画数据添加内存压缩。大型整合包的内存占用应有所降低
• 为 Molang 中 Actor 变量的无效使用添加了安全检查
• GeckoLib 实体渲染现已自动兼容 NeoForge 的 EntityRenderState 修改器
• 覆盖了原版对实体名称牌渲染距离 64 方块的硬性上限。你现在最多可设置为 256 方块
• 修复了 GeoBones 的世界空间定位未考虑部分游戏刻插值的问题
• 修复了非生物实体渲染时未正确处理 Y 轴旋转的问题
• 修复了死亡旋转在部分游戏刻下重复叠加的问题
• 修复了 GeoObjectRenderer 中 BufferSource 未被正确设为非空的问题
• 修复了 GeoEntityRenderer 在重新渲染时重复应用其他 PoseStack 操作的问题
• 将大量渲染值创建逻辑移回原版实现，以提升与原版及其他模组的兼容性
• 移除了 AnimationProcessor 中多个冗余的方法参数
• 将 AnimationController#process 重命名为 AnimationController#startTick
• 修复了 DefaultAnimations#genericFlyController 在不移动时无法停止的问题
• 将 AnimationState 的处理提前至渲染之前，以优化 Molang 查询的填充
• 修复了 AnimationController 的动画速度可能在单次渲染过程中被多次重新计算，导致动画处理不一致的问题
• 将 Keyframes 重命名为 KeyframeMarkers
• GeckoLib 现在会预先确定每帧渲染所使用的 Molang 查询，并预先计算所有相关值并缓存，从而支持更复杂的动画
• 将 AnimatableManager 及其派生类移至不同包中
• 将 AnimationController、AnimationProcessor、AnimationState 移至不同包中
• 将 AutoPlayingSoundKeyframeHandler 移至不同包中
• 移除了 AnimationPointQueue
• 将骨骼级渲染层的渲染移至其余渲染完成之后执行
• 调整了 DyeableGeoArmorRenderer 的工作方式，使其更加准确
• 修复了多个 GeoRenderEvent 类中的 Javadoc 错误

API 变更

• 所有 GeckoLib 资源现位于 /assets/geckolib/ 下
  • 动画文件位于 /assets/<modid>/geckolib/animations/
  • 模型文件位于 /assets/<modid>/geckolib/models/
• 所有 GeoRenderer 现在基于 GeoRenderStates 运行，而非传递 animatable 对象。Mojang 已明确表示这是我们必须采用的方式 :(
  • 移除了 GeoRenderer#getAnimatable
  • 从 GeoRenderer 的方法中移除了多个参数，默认移至 GeoRenderState
  • 移除了 GeoEntityRenderer#isShaking
• AnimationState 现在是用于在处理过程中传递动画状态的内部类。用户现在应使用 AnimationTest，其功能相同
• GeoRenderer 扩展现在接受第二个泛型类型，即 RenderState 类型（以及 GeoRenderState）
• GeoModel 的模型/动画引用不再需要文件路径前缀或后缀（例如，返回的模型资源中无需包含 geo/ 或 .geo.json）
• DataTicket 现在必须通过工厂方法创建，以确保身份一致性
• SerializableDataTicket 不再需要注册，但仍必须在模组构造阶段创建
• GeoRenderer 中所有渲染方法的参数顺序已调整：PoseStack 和 RenderState（原 Animatable）位置互换
• Molang 变量现在均为基于当前渲染通道的 AnimationState 运行的函数
• AnimationController 不再需要传入 animatable 对象
• 拆分了 AutoGlowingGeoLayer 中纹理获取与使用逻辑，以便模组按需覆盖纹理
• 所有 DefaultAnimations 辅助方法现在默认使用 0 游戏刻过渡时间，以保持一致性与清晰性
• 将 FormatVersion 转换为字符串，并采用更灵活的系统
• 引入基于身份的查找机制用于同步单例 animatable 对象，以期消除类重复冲突
• 将 AnimationState#getData 标记为可空，以避免混淆
• 将 EasingType 中的 easingType 参数标记为可空，以避免混淆
• 清理了 EasingType 的 Javadoc
• GeoReplacedEntityRenderer 现在在尝试将实体作为 animatable 插入时会显式崩溃，以防止内存泄漏
• 使 GeoReplacedEntityRenderer 与 GeoEntityRenderer 更加一致，以确保准确性
• CustomInstructionKeyframeEvent、SoundKeyframeEvent 和 ParticleKeyframeEvent 已合并为 KeyFrameEvent
• CustomInstructionKeyframeHandler、SoundKeyframeHandler 和 ParticleKeyframeHandler 已合并为 KeyframeEventHandler
• 将 KeyFrameEvent 转换为 record 类型
• 将 Calculation 转换为 record 类型
• MolangQueries 再次变为环境无关（side-agnostic）
• GeoRenderer 的多个部分现在额外提供关联对象用于处理（ItemStack、替换实体等）
• 将 prepLivingEntityRenderState 移入 GeoEntityRenderer，以便必要时可被覆写
• 移除了 EntityModelData
• 移除了 DeferredGeoRenderProvider
• 移除了 InternalUtil
• 移除了 FileLoader
• 移除了 Color，现已完全由 net.minecraft.util.ARGB 取代
• 从各类 GeoModel getter 方法中移除了 GeoRenderer 参数，因其已不再需要
• 重命名了 GeoArmorRenderer 中的骨骼变量，以避免与 HumanoidArmorModel 的字段名冲突
• 将 GeckoLibCache 重命名为 GeckoLibResources
• 将 AnimatableManager#setData 重命名为 AnimatableManager#setAnimatableData（及其对应的 getter）
• 将 AutoGlowingTexture#getEmissiveResource 重命名为 #getOrCreateEmissiveTexture 以提高清晰度
• 将 GeoEntityRenderState 移至 GeoRenderState
• GeckoLibUtil 中的各类单例注册辅助方法已移至新的 SyncedSingletonAnimatableCache，相关方法的层级作用域也已缩小，以提高清晰度与安全性
• 将 GeoRenderLayer#renderForBone 重命名为 #createPerBoneRender，现在要求你返回一个稍后执行的 Runnable 操作
• 移除了 DynamicGeoBlockRenderer、DynamicGeoEntityRenderer 和 DynamicGeoItemRenderer。请改用渲染层处理骨骼特定逻辑。我将研究为此创建辅助类或其他替代方案
• 改进了各类 GeoRenderEvent 的泛型类型，使其更具实用性

新增内容

• 为 SingletonGeoAnimatable 添加了 stopTriggeredAnimation
• 添加了 triggerArmorAnim 用于触发护甲动画 (#433)
• 添加了 query.controller_speed Molang 查询
• 添加了 query.limb_swing Molang 查询
• 添加了 query.limb_swing_amount Molang 查询
• 为基岩版风格动画 JSON 添加了 Catmull-Rom（平滑）缓动原生支持（感谢 Zigy 的初始工作）
• 带动画的纹理现已支持发光遮罩 (#456)
• 在 GeoRenderer 中添加了 #setBonesVisible 辅助方法，便于使用
• 添加了 AnimationController#isTriggeredAnimation 用于检查当前触发的动画
• 添加了 AnimationController#setAnimationState 用于在必要时直接设置控制器状态
• 为每种渲染器类型添加了 CompileRenderState 事件钩子