概述
Forge 动画API允许您用JSON(和B3D)模型设置动画。 在开始阅读本文之前,您应该知道如何创建原本JSON模型 阅读有关方块状态的文档。
提示
虽然您也可以用B3D模型,但本文档的大部分内容都假设您使用的是JSON文件。 (未完成)有关详细信息,请参阅有关使用B3D的页面
Animation API由两个主要组件组成:骨架(Armature)文件和动画状态机(ASM)文件。
骨架文件定义JSON文件的关节和剪辑。 关节是模型文件中最主要的长方体的名字(有关详细信息,请参见骨骼),而剪辑是一组随时间推移应用于关节的变换(例如,想想电影中的剪辑)。 ASM文件定义动画可以处于的各种状态,以及什么这些状态之间存在过渡。 它们还定义了动画的参数(返回浮点数的函数),这些参数通常用作剪辑的输入,但也可以触发事件。 事件本质上是一种在动画到达某个点或触发转换时接收代码内通知的方法。
文件结构约定
ASM文件,方块通常存储在asms/block
,item储存在asms/item
等等。您可以指定从哪里加载它们,因此它们的位置有你决定。
骨骼文件_必须_存储在armatures
文件夹中。 通过模型文件的路径来查找它们,删除models/
下的armatures/
,如models/block/test.json
中的模型放在armatures/block/test.json
。