AnimationPlayer 节点在 ACTION GAME MAKER 中是一个原生的 Godot 节点。本手册将介绍其部分核心功能。
AnimationPlayer 的功能
AnimationPlayer 是一个基于时间轴的播放系统,可控制多个轨道,其工作流程类似于视频编辑工具。
添加轨道
从各个属性添加
选中 AnimationPlayer 节点并打开面板后,选择另一个节点时,其属性旁会显示一个钥匙图标。
点击该图标将创建轨道并插入关键帧。
从时间轴添加
在时间轴中,点击“添加轨道”并选择要跟踪的属性。
对于属性轨道,先选择节点,再选择具体属性。
通过编辑器按钮添加关键帧(仅限位置、旋转、缩放)
主要用于骨骼动画。
切换选项可确定在选定时间点插入哪些变换(位置、旋转、缩放)。
如果启用录制按钮,对这些值的更改将自动添加到时间轴中。

关于 RESET 轨道
添加新轨道时,系统可能会提示是否添加 RESET 轨道。
简而言之:您不需要添加它。
RESET 轨道用于将属性值恢复为默认状态,但 ACTION GAME MAKER 的可视化脚本不使用它。
不过请注意:在编辑器中,对象将默认使用 RESET 轨道中的值。
如果您在编辑器中禁用了某项功能,但在 RESET 轨道中启用了它,该功能在游戏中将显示为启用状态——因此最安全的做法是跳过添加它。
修改碰撞形状
若要动画化碰撞形状的大小(例如 RectangleShape2D、CapsuleShape2D),请展开节点内的形状资源,并选择内部属性。
属性使用示例
您可以动画化几乎任何属性,从而开启多种可能性:
- 启用/禁用伤害判定框或碰撞体
在碰撞节点上使用Disabled属性。 - 切换精灵
切换Sprite2D节点的Visible属性,以更改武器或特效等视觉效果。 - 自定义设置更改
使用MoveAndJumpSettings或BaseSettings来动画化速度提升、重力、攻击力等。 - 触发粒子效果
动画化Particles节点的Emitting属性以开启/关闭效果。 - 声音播放
动画化AudioStreamPlayer节点的属性以播放/停止音频。 - 着色器过渡
动画化着色器参数,以创建渐变视觉效果(如扭曲)。
缓动(Easing)
默认情况下,动画值以线性方式插值。
例如,如果值在 0 秒时为 0,在 1 秒时为 1,则在 0.5 秒时为 0.5。
缓动允许您更改该曲线——例如,您可以将中间值设为 0.1。
每个关键帧都可以拥有自己的缓动值(它影响该关键帧之后的区间)。
贝塞尔曲线
在插入关键帧时,您可以创建贝塞尔曲线轨道。
与缓动不同,贝塞尔轨道允许在两个点之外进行自由曲线控制。
点击轨道面板中的曲线图标以打开曲线编辑器。
您可以使用标准手柄编辑曲线。
时间注意事项
在 AnimationPlayer 中,下一个动画在当前动画结束后才开始。
例如,在 60 FPS 下,长度为 1.0 秒的动画在第 59 帧结束。
下一个动画从 1.002 秒开始,导致 0.002 秒的延迟。
通常情况下这不易察觉,但:
- 如果一个动画在其末尾启用了伤害判定框,
- 而下一个动画在其开头禁用了该判定框,
这可能会导致判定框短暂保持激活状态,从而造成意外的额外命中。






