GeckoLib

壁虎库（GeckoLib）v5.0-alpha1

注意事项

• 截至alpha1版本，发光遮罩和动画纹理尚无法正常使用。这一问题很快就会解决哦 :)
• 此外，由于Mojang使得之前的动态渲染器不再实用，我正在研究针对逐骨骼渲染处理的替代解决方案。
• 如果您使用了这些功能中的任何一项，请等到5.0正式版发布后再使用，谢谢。

常规变更

• 已更新至《我的世界》1.21.5版本
• 已将更新日志转换为Markdown格式

内部变更

• 重写了资源加载系统，以便在不影响输入输出（I/O）的情况下正确处理并行化的资源。
• 让GeoArmorRenderer从HumanoidArmorLayer#setPartVisibility继承骨骼可见性，以便更好地与第三方模组协同工作。
• 将默认的boneResetTime设置为5刻，并在刻时间为0时自动完成重置。这可避免不可避免的部分刻骨骼重置。
• 修复了在同步可动画物品上中键点击时，若使用触发动画或同步数据会导致冲突的问题（#681）。
• 现在，使用动画进行完整旋转的骨骼在重置时不应再反向旋转，从而使旋转动画更加流畅。
• 同步可动画物品之间不再相互阻止堆叠。
• 为动画数据添加了内存压缩。较大的模组包应能减少内存使用量。
• 为在Molang中无效使用角色变量添加了一项安全检查。
• 壁虎库（GeckoLib）实体渲染现在自动与新Forge（NeoForge）实体渲染状态修饰符兼容。
• 覆盖了原版对实体名牌渲染的64格默认硬限制。现在您可以将其扩展至256格。
• 修复了GeoBones上的世界空间定位未考虑部分刻线性插值的问题。
• 修复了非生物实体在渲染时未考虑其Y轴旋转的问题。
• 修复了死亡旋转在部分刻加倍的问题。
• 修复了在GeoObjectRenderer中BufferSource未正确设置为非空的问题。
• 修复了GeoEntityRenderer在重新渲染时重新应用其他PoseStack操作的问题。
• 将大量渲染值创建工作移回原版，以便更好地与原版及其他模组兼容。
• 在整个AnimationProcessor中删除了一些多余的方法参数。
• 将AnimationController#process重命名为AnimationController#startTick。
• 修复了DefaultAnimations#genericFlyController在不移动时不停下来的问题。
• 将动画状态移至渲染之前，以便优化Molang查询填充。
• 修复了AnimationController的动画速度可能在每次渲染过程中多次重新计算，导致动画处理不一致的问题。
• 将Keyframes重命名为KeyframeMarkers。
• 壁虎库（GeckoLib）现在会预先确定在任何给定渲染帧中将使用哪些Molang查询，并预先计算所有相关值并进行缓存。这使得复杂动画成为可能。
• 将AnimatableManager及其所有派生类移至不同的包。
• 将AnimationController、AnimationProcessor、AnimationState移至不同的包。
• 将AutoPlayingSoundKeyframeHandler移至不同的包。
• 删除了AnimationPointQueue。
• 将逐骨骼渲染层渲染移至其余渲染完成之后。
• 更改了DyeableGeoArmorRenderer的工作方式，使其更加准确。
• 修复了各种GeoRenderEvent类中的一些Javadoc错误。

API变更

• 所有壁虎库（GeckoLib）资源现在都放在/assets/geckolib/中
  • 动画放在/assets/<模组ID>/geckolib/animations/中
  • 模型放在/assets/<模组ID>/geckolib/models/中
• 所有GeoRenderers现在都基于GeoRenderStates运行，而不是传递可动画对象。Mojang已经明确表示我们必须这样做 :(
  • 删除了GeoRenderer#getAnimatable。
  • 从GeoRenderer的方法中删除了各种参数，默认将它们移至GeoRenderState。
  • 删除了GeoEntityRenderer#isShaking。
• AnimationState现在是一个内部类，用于在处理过程中携带动画状态。用户现在应使用AnimationTest。它们在功能上是相同的。
• GeoRenderers扩展现在接受第二种泛型类型；即渲染状态类型（以及GeoRenderState）。
• GeoModel模型/动画引用不再需要文件路径前缀或后缀（即，您在返回的模型资源中无需包含geo/或.geo.json）。
• DataTicket现在需要通过工厂方法创建，以确保标识一致性。
• SerializableDataTicket不再需要注册，但在模组构造期间仍必须创建。
• GeoRenderer中的所有渲染方法在参数中将PoseStack和渲染状态（之前是可动画对象）的位置进行了交换。
• Molang变量现在都是针对当前渲染过程中的AnimationState进行操作的函数。
• AnimationController不再需要传递可动画对象给它。
• 在AutoGlowingGeoLayer中拆分了纹理检索和使用，以便模组可以根据需要覆盖纹理。
• 所有DefaultAnimations助手现在为了一致性和清晰性，默认过渡时间为0刻。
• 将格式版本转换为字符串，并将其转换为一个更灵活的系统。
• 为同步单例可动画对象引入了基于标识的查找，希望能消除类重复冲突。
• 将AnimationState#getData标记为可空，以避免混淆。
• 将EasingType中的easingType参数标记为可空，以避免混淆。
• 清理了EasingType的Javadoc。
• GeoReplacedEntityRenderer现在在尝试将一个实体作为可动画对象插入时会明确报错，以防止内存泄漏。
• 使GeoReplacedEntityRenderer与GeoEntityRenderer更加一致，以确保准确性。
• CustomInstructionKeyframeEvent、SoundKeyframeEvent和ParticleKeyframeEvent都已合并到KeyFrameEvent中。
• CustomInstructionKeyframeHandler、SoundKeyframeHandler和ParticleKeyframeHandler都已合并到KeyframeEventHandler中。
• 将KeyFrameEvent转换为记录类型。
• 将Calculation转换为记录类型。
• MolangQueries再次与边无关。
• GeoRenderers的各个部分还额外提供了一个相关对象用于处理（物品堆、被替换的实体等）。
• 将prepLivingEntityRenderState移至GeoEntityRenderer中，以便在需要时可以被重写。
• 删除了EntityModelData。
• 删除了DeferredGeoRenderProvider。
• 删除了InternalUtil。
• 删除了FileLoader。
• 删除了Color。它已完全被net.minecraft.util.ARGB所取代。
• 从各种GeoModel获取器中删除了GeoRenderer参数，因为它已不再需要。
• 重命名了GeoArmorRenderer中的骨骼变量，以防止与HumanoidArmorModel的字段名冲突。
• 重命名了GeckoLibCache为GeckoLibResources。
• 重命名了AnimatableManager#setData为AnimatableManager#setAnimatableData（及其相关的获取器）。
• 为重命名AutoGlowingTexture#getEmissiveResource为#getOrCreateEmissiveTexture，以提高清晰度。
• 将GeoEntityRenderState移至GeoRenderState。
• GeckoLibUtil中的各种单例注册助手已移至新的SyncedSingletonAnimatableCache，相关方法的层级范围已缩小，以提高清晰度和安全性。
• 重命名了GeoRenderLayer#renderForBone为#createPerBoneRender，现在要求您将操作作为一个可运行对象返回，以便稍后运行。
• 删除了DynamicGeoBlockRenderer、DynamicGeoEntityRenderer和DynamicGeoItemRenderer。请使用渲染层来进行针对骨骼的特定处理。我将考虑为此创建一个辅助类或其他替代选项。
• 改进了各种GeoRenderEvent的泛型类型，使其更有用。

新内容

• 为SingletonGeoAnimatable添加了stopTriggeredAnimation方法。
• 添加了triggerArmorAnim用于触发盔甲动画（#433）。
• 添加了query.controller_speed Molang查询。
• 添加了query.limb_swing Molang查询。
• 添加了query.limb_swing_amount Molang查询。
• 为基岩版风格的动画JSON添加了对卡特穆尔-罗姆（平滑）缓动的原生支持（感谢Zigy的前期工作）。
• 动画纹理现在支持发光遮罩（#456）。
• 在GeoRenderer中添加了#setBonesVisible辅助方法，以便于使用。
• 添加了AnimationController#isTriggeredAnimation用于检查当前触发的动画。
• 添加了AnimationController#setAnimationState，如有必要可直接设置控制器的状态。
• 为每种渲染器类型添加了CompileRenderState事件钩子。