SimpleAnimator

SimpleAnimator

这是用于播放器的动画师库

基础库

功能特性

SimpleAnimator 是一款简易动画引擎,允许玩家使用基岩版动画来回放玩家动画。

在线游玩时,客户端会同步服务器加载的动画。

动画

可通过 BlockBench 制作动画,必要时可在动画导出后手动添加一些特殊布尔值:

  • override:指定动画是否覆盖现有动作和镜头朝向。默认值为 true。若设为 false,则动画以附加模式运行。
  • movable:播放动画时玩家是否可以移动。默认值为 false。
  • abortable:动画是否可以被中止。默认值为 true。若设为 false,则动画无法被玩家操作打断(若动画处于循环模式,不建议设置为此值)。

此外,可在 GitHub 下载相应格式的 BlockBench 项目文件,以方便制作动画。

本模组提供两种添加动画的方式:
数据包:
面向模组开发者,您可以选择将动画放入 data/[modid]/animations。
API 及更多细节将在此后版本的文档中补充。
文件夹:
面向大多数玩家,可将动画文件放入 [游戏版本路径]/animations 中以完成加载。

交互

交互是模组 1.1.0 版本后新增的功能,允许两名玩家进行交互并播放动画(在网络不稳定的情况下可能出现错位现象)。
交互文件的导入方式与普通动画类似,但需要在动画文件中添加子动画:invite、waiting、cancel(可选)。
此外,动画骨骼需包含以 requester_ 和 receiver_ 前缀命名的骨骼。具体格式可查看 GitHub 中的 Starting-Kit.interact.bbmodel。

指令

/animate play <动画> /animate stop /interact invite <玩家> <交互>
/interact accept <玩家>