PlayerAnimator (Unofficial 1.21.10 Port)

⚠️ 非官方移植版

这是面向 Minecraft 1.21.10 的非官方社区移植版

• 原作者： KosmX
• 原项目： GitHub | Modrinth
• 许可证： MIT 许可证（版权所有 © 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 团队提供的优秀模组开发工具
• 原项目的所有贡献者