PlayerAnimator (Unofficial 1.21.10 Port)

⚠️ 非官方移植版

这是由社区制作的非官方移植版，适用于 Minecraft 1.21.10

• 原作者： KosmX
• 原项目： GitHub | Modrinth
• 许可证： MIT License（版权所有 © 2022 KosmX）

原作者已不再维护 PlayerAnimator，并建议改用 PAL。

PlayerAnimator 是什么？

PlayerAnimator 是一个 Minecraft 前置库，可在尽可能减少模组冲突的同时，为玩家添加动画。

此移植版调整了该前置库，使其能够在 Minecraft 1.21.10（Fabric）中运行。

功能

✅ 已支持

• 完整的玩家模型动画系统
• 位置、旋转、缩放和弯曲变换
• 带优先级系统的动画图层
• 支持 JSON 动画（GeckoLib 和 Emotecraft 格式）
• 第一人称动画模式
• 手持物品动画
• 动画期间鞘翅位置正确

⚠️ 限制

• 不支持 bendy-lib – 无法实现平滑的身体弯曲（尚无 1.21.10 版本）
• 动画看起来不够流畅
• 身体部位无法从中间弯曲
• 盔甲显示 – 第一人称视角下的盔甲可能无法正确显示

玩家须知

只需将此模组作为前置库安装即可——它本身不会产生任何效果。其他使用 PlayerAnimator 的模组会在安装此模组后启用其动画。

开发者须知

此 API 与原版 PlayerAnimator 完全兼容：

// Get player's animation stack
AnimationStack stack = PlayerAnimationAccess.getPlayerAnimLayer(player);

// Add animation layer
stack.addAnimLayer(new ModifierLayer<>(animation));

// Load animation from JSON
AnimationContainer animation = PlayerAnimationRegistry.getAnimation(
    new Identifier("modid", "animation_name")
);

Gradle 配置

 repositories {
      maven { url 'https://jitpack.io' }
  }

  dependencies {
      modImplementation "com.github.TOSTcRa:playerAnimator-1.21.10:v2.0.1-1.21.10-unofficial"
      include "com.github.TOSTcRa:playerAnimator-1.21.10:v2.0.1-1.21.10-unofficial"
  }

模型结构

动画使用以下身体部位：

• head / body（整个玩家）/ torso（胸部）
• rightArm / leftArm / rightLeg / leftLeg

将动画放置于：assets/modid/player_animation/

链接

• 原版 GitHub
• 推荐替代方案：PAL
• 移植技术细节

致谢

• KosmX – PlayerAnimator 原作者
• 感谢 Fabric 团队提供优秀的模组开发工具
• 感谢原项目的所有贡献者