Entity Animation Helper

动画助手

一款适用于 Minecraft 1.20.6的 Fabric 模组，可让你用数据包 JSON 定义实体动画。
动画既可作为一次性动作播放（例如拉弓、表情动作），也可从模型的setAngles中持续播放。

功能

• 数据包驱动：将文件放入data/<namespace>/animations/即可注册。
  服务器会在玩家加入时和/reload时将定义同步到客户端。
• 关键帧轨道：可逐部位设置旋转、平移和缩放，并使用缓动曲线。
• 混合与图层：支持淡入淡出、图层优先级、循环和播放速度。
• 姿势锁定：动画播放期间可锁定头部、身体朝向、躯干、手臂或腿部。
• 第一人称支持：动画手臂可在第一人称视角下渲染。
• 模型基类：为自定义生物提供AnimatedEntityModel和AnimatedCreatureModel。

快速入门

创建data/mymod/animations/wave.json（ID mymod:wave）：

{
  "length": 20,
  "fade_in": 3,
  "fade_out": 3,
  "tracks": [
    {
      "part": "right_arm",
      "rotation": [
        { "time": 0,  "value": [0, 0, 0] },
        { "time": 10, "value": [-160, 0, 20], "easing": "ease_out" },
        { "time": 20, "value": [0, 0, 0],     "easing": "ease_in_out" }
      ]
    }
  ]
}

在游戏中播放：

/anim play @s mymod:wave

或通过服务端代码播放：

AnimationController.play(entity, new Identifier("mymod", "wave"));

命令

/anim list [targets]
/anim play <targets> <animation> [speed] [loop]
/anim stop <targets> [animation]
/anim reload

/anim是/animationhelper的别名。两者都需要2级权限。

文档

docs/animation.md详细介绍了完整的 JSON 结构、部位名称、
缓动曲线、命令、Java API 和模型基类。

运行要求

Minecraft 1.20.6、Fabric Loader ≥ 0.18.4、Fabric API、Java 21。

许可证

CC0 1.0