玩家动画师（非官方1.21.10移植版）

Minecraft 1.21.10 的非官方社区移植版 PlayerAnimator 库 - 在保持模组兼容性的同时为玩家添加动画

基础库

⚠️ 非官方移植版

这是 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 完全兼容：

// 获取玩家的动画栈
AnimationStack stack = PlayerAnimationAccess.getPlayerAnimLayer(player);

// 添加动画层
stack.addAnimLayer(new ModifierLayer<>(animation));

// 从 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/

链接

致谢

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