索引
| 动画控制器 |
|---|
| 状态融合 |
| 状态转移 |
| 状态 |
| 通道（旋转，位置，缩放） |
| 实体动画格式示例 |
| 准备开始 |
| 添加动画 |
| 动画层阶 |
| 从v1.10升级到v1.17.30 |
| 从v1.17.30升级到v1.18.10 |
| 从v1.18.10升级到v1.18.20 |
| 从v1.7测试版升级到v1.8 |
| 从v1.8测试版升级到v1.10 |
| 关键帧 |
| 插值 |
| 命名 |
| 概述 |
| 渲染控制器 |
| 示例 |
| 准备开始 |
| 变换 |
动画控制器
动画控制器决定何时播放哪些动画。每个控制器都包含一个状态列表，这些状态可以播放一个或多个动画，如果需要，每个动画都可以通过 Molang 表达式进行混合。控制器文件以 JSON 格式存储在 animation_controllers 文件夹中 动画控制器格式：状态融合
如果您希望在过渡时状态之间出现交叉淡化，只需将 “blend_transition” 设置为您希望系统在两种状态之间混合的时间。这是在指定时间内在两个状态之间进行简单的插值完成的。 例如：状态转移
状态可以指定任意数量的过渡脚本，按顺序列出。每个转换都有一个要切换到的目标状态，以及一个用于是否应切换的脚本。按顺序对于每个转换，评估脚本，如果它返回非零，则立即切换到指定的状态。注意：每帧将只处理一个过渡。状态
一个状态定义了一组需要处理的动画（其中每一个都可以具有其自己的融合值）。每个状态都有一个可选的variables段落，列出着所引用的动画可以使用的任意数量的变量。每个状态还可以具有一个或多个动画，它们使用实体定义JSON文件中给出的短名称。状态变量
变量既可以由游戏设置，也可以由一个在definitions/entity/<entity_name>.json处的实体定义JSON中的用户定义的脚本中设置。变量可以通过Molang表达式定义它们的值。也可以通过一个线性插值曲线将它们的值进行重新映射。示例：
这里定义了一个单状态的控制器。它将创建一个变量`variable.ground_speed_curve`，仅当游戏处理该动画控制器的那一帧时，该变量才会存在在这个实体上。它将取`query.ground_speed`的值，然后基于`query.ground_speed`从0.0走到1.0的值把它重映射到0.2至0.7之间。它将在实体的地面速度从停止不动至2.3m/s时播放一个从0.0至1.0融合的walk动画。重映射曲线可以有任意多项。接下来，该动画控制器将播放从实体中引用的`wiggle_nose`动画，紧跟着播放`walk`动画，并将后者通过`variable.ground_speed_curve`的值进行缩放用户自定义脚本示例
此脚本将 foo 设置为 query.life_time 的正弦结果，以便稍后在动画或动画控制器中使用。注意： “pre_animation” 告诉脚本在动画发生之前，每帧计算出一次这些变量的值，以便动画可以在自己的公式中使用这些值。如果变量不存在，它将创建一个新变量，其默认值为 0.0 请注意，在此示例中，由于 foo 等于正弦波，其值范围将从 -1 到 1。这意味着您将有一个从 0 到 -1 再到 0 的周期，在此期间只有 "base_pose" 会播放，然后当 foo 从 0 到 1 再回到 0 时，Walk 将在 base_pose 之上播放相同的时间。Base_pose 的混合值将为 1.0。在definitions\entity\tiger.json中
通道（旋转，位置，缩放）
引擎可以分别追踪一个动画的旋转、位置和缩放。在一个通道中，可以以秒为单位在从动画开始处之后的任意时刻指定一个或多个关键帧。如果没有指定关键帧，引擎将在t=0.0处创建一个单一的关键帧，所有的通道数据都存储在这个关键帧中。返回顶部实体动画格式示例
动画的JSON格式如下所示。注意：与几何中的格式一致，长度单位为1/16米。准备开始
添加动画
动画控制器
创作者们需要能够控制动画如何进行播放，以及动画何时和通过何种方式来与其他动画交互。要想整合动画，尽管在实体的定义文件的`scripts/animate`段落中就可以管理许多动画，动画控制器给予了你状态机划分状态的功能，并能够分块对动画进行控制。动画控制器里每个状态中的动画都可以是其他的动画控制器，这允许你定义出任意复杂的动画层阶。 这里是一个动画控制器的示例动画
在每一帧的的开始，骨架将重置为其几何定义中默认姿势，然后动画将按照顺序逐通道叠加应用在骨架上。注意，各通道（的x、y和z）将先分别添加在各个动画上，然后在所有动画都被逐次应用之后再被转换成一个变换。动画数据可以是原始数据：
默认情况下旋转角是角度制的，顺序为欧拉X-Y-Z格式也可以是一个在运行时的解释器中解释的脚本：
实体定义
要定义一个实体都具有哪些动画，你必须同时向一个实体的实体定义文件中添加一个`animations`和一个`scripts/animate`段落。 这里你能看到pig.json的实体定义文件：注意
注意：pig 的行走动画与 cows 和 sheep 相同，因此使用 animation.quadruped.walk 而不是定义自己的动画。这意味着您也不会在 pig.json 动画文件中看到移动动画。如果您想进行自定义猪走路，可以将此行更改为指向您的自定义动画。动画是由一个短名称，后面跟着它们的完整资源名来指定的。短名称可以用在动画控制器和`scripts/animate`列表中，而长名称则用在动画文件中。在`scripts/animate`段落中，你可以列出要播放的动画以及它们的顺序。你可以直接指定一个动画，也可以指定一个融合表达式。返回顶部动画层阶
动画是基于通道的（旋转、位置或缩放），其中，它们是关键帧的：EntityAnimation：动画名称__BoneAnimation[]： 此动画的动画的骨骼名称____AnimationChannel[]：要进行动画处理的旋转、缩放或平移______KeyFrame[]：在特定时间要位于的通道的值下面以详细的、自下而上的方法描述了上述所有概念返回顶部从v1.10升级到v1.17.30
1.17.30 的主要变化是：- 现在，可以正确评估包含大写字母的过渡中的 Molang 表达式。此类表达式中的字符串不再强制为小写，并按预期工作。返回顶部从v1.17.30升级到v1.18.10
1.18.10 的主要变化是：- 修复了以下问题：如果控制器立即过渡到另一个状态，则会跳过在默认状态中定义的动画控制器事件。返回顶部从v1.18.10升级到v1.18.20
1.18.20 的主要变化是：- 现在可以正确评估角色资源定义（pre_animation 和 initialize）的动画脚本中包含大写字母的 Molang 表达式。此类表达式中的字符串不再强制为小写，并按预期工作。返回顶部从v1.7测试版升级到v1.8
当我们根据反馈整理代码和沿着路线图推进技术时，我们做出了一些变更。要升级先前的Molang脚本，你需要按照列出的顺序对你所有的脚本执行以下步骤：1) entity.flags.foo --> query.foo2) entity.member.foo --> query.foo3) entity.foo --> variable.foo4) params.foo --> global.foo5)总体规律是：“query”表示正在运行脚本的实体的只读数据，而“variable”表示由用户创建的可读可写的数据。6)我们已经采用了snake_case蛇形命名法来命名所有事物的名称。由于我们的游戏大小写敏感，所以只要你愿意，你依旧可以使用大写字母，但是我们建议一般情况下使用snake_case格式.7)先前设置到生物上的一些变量已经更改为query.foo格式。请浏览下方的更新内容列表来查看加入和更改的内容。返回顶部从v1.8测试版升级到v1.10
在1.10中有三个主要变更，它们分别是- 动画现具备以任意深的层阶引用其他动画的能力。- 动画控制器的参数段落已经被`variables`段落取代。- 在实体定义文件中，动画控制器现在被列在`animations`段落中，并且添加了`scripts/animate`段落来定义要播放哪个根动画。v1.8的文件格式是向后兼容至v1.10的，所以你无需进行任何改变（尽管我们建议按照v1.10的精神重构你的文件，因为新格式在性能上有一些优势，并且更易理解）。返回顶部关键帧
一个关键帧为位于指定时刻的特定骨骼上的特定通道的变换定义了两个值，一个是迫近该关键帧时刻时的终值，另一个是在关键帧时刻达到之后的初值。同样的，当在两个关键帧之间插值时，你可以以其斜率连续或不连续的方式定义动画变换曲线。插值
目前仅支持线性插值。关键帧的 “pre” 和 “post” 设置允许控制任何关键帧的插值曲线。连续的示例
此示例在 1 秒内围绕 y 轴旋转 1 圈的骨骼“头部”。请注意，由于插值是线性的，因此在 .25 秒时，头部将旋转 90 度。不连续的示例
不连续意味着关键帧之间不会有一个平滑的过渡。当你想要一些东西突然发生时，这将非常有用。这个例子缩放了“head”骨骼:1. 从0到0.5秒（在“pre”标签处），head骨骼在所有的[X, Y, Z]三个维度上被设置为其正常缩放值1命名
所有的命名：动画、骨骼、状态等，都必须以一个字母开头，只包含字母、数字、下划线和英文句点。我们建议命名时字母全部使用小写返回顶部概述
以下是当前的Minecraft JSON范式：- 字段中的字母一律使用小写，并使用下划线且不带空格- 定义目录及其子树中的所有JSON文件都将读取到动画系统并被系统的解释器解释返回顶部渲染控制器
渲染控制器需要一个标识符，并且需要遵循"controller.render.<name>"的格式。此名称需要与客户端实体定义 JSON 中设置的名称匹配。渲染控制器是玩家确定在实体上渲染什么的一种方式。玩家可以设置实体的几何体、材质、纹理和零件可见性。除了直接设置键之外，玩家还可以使用数组让实体在不同的选项之间进行选择。示例
来自于绵羊JSON的几何数组示例注意
注意：Materials （材质） 和 Part visibility （零件可见性） 的数组将按指定的顺序应用。稍后在文件中指定的材质和零件可见性将覆盖以前的材质或零件。 来自马渲染控制器的材质数组示例。Saddle将覆盖Mane，然后Mane将覆盖TailA，等等：准备开始
首先，在资源包的根目录中创建一个名为 “render_controllers” 的新文件夹，以便在其中添加新的渲染控制器 JSON。 豹猫的渲染控制器JSON示例：变换
- 运算顺序：各顶点先平移，再旋转，然后缩放。