Agent Skills
返回列表
💻

Godot AnimationTree 动画树精通

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-animation-tree-mastery。

技能介绍

你在对抗什么问题

Godot 里一旦上 AnimationTree,最常见的事故是:代码里还在对 AnimationPlayer 调 play(),树和播放器抢控制权,表现为抖动、状态错乱;或者忘了 $AnimationTree.active = true,图编好了却永远不播。更隐蔽的是每帧无脑 set("parameters/..."),缓存被反复打掉,掉帧却找不到节点。

本技能围绕「树拥有播放器」这条契约,把 StateMachine travel、BlendSpace1D/2D 选型、BlendTree 上层叠加、嵌套子状态机交接、以及 Method Track 事件分发,收成可对照脚本与决策表的工作流。

技能如何帮你落地

  • 决策表:简单换片用 Player;五档以上玩法状态用 StateMachine + travel();只混速度用 BlendSpace1D;八向走位/瞄任用 BlendSpace2D;上半身战斗层用 Add2/Blend2/OneShot。
  • 配套脚本模式:sync_parameter_manager.gd 做相等性守卫;statemachine_travel_code.gd / tree_travel_manager.gd 集中 travel 请求;嵌套 locomotion+combat 必读 nested_state_machine.gd;IK/瞄准旁路用 skeleton_ik_lookat.gd。
  • 设计取舍:advance condition 适合伤害/死亡等事件;玩家意图移动应用 travel()。长过场别依赖 auto_advance;长度差异巨大的动画别硬绑 Sync 组。

边界与注意点

技能刻意不贴完整编辑器教程,默认你在 AnimationTree 里建好图,再用脚本驱动。references/advanced-graph-recipes.md 仅在深度 BlendTree、嵌套战斗图、IK 叠层时才加载。2D 裁切可走相关 Godot 2D 动画技能;玩法意图层 FSM 应与 godot-state-machine-advanced 分工:玩法管意图,树管呈现 travel 与混合。

使用场景

  • 把角色从多套 AnimationPlayer 直播迁到 AnimationTree,需要按 locomotion/combat 分状态并用 travel 切态
  • 每 physics frame 更新 blend_position 或行走速度参数,动画卡顿,需要带相等性检查的参数写入
  • 下半身走路、上半身瞄准/换弹要叠加,要在 BlendTree 里配 Add2/Blend2 与骨骼过滤掩码
  • FPS 后坐力或受击 blink 要打断循环层,需用 OneShot 的 FIRE/ABORT 且禁止对 Player 调 play()

适合人员

  • 做 3D 动作/射击项目的 Godot 程序员,要把状态机混合从试错改成按 NEVER 清单与脚本模板实现
  • 负责角色移动与战斗分层的 gameplay 工程师,需要在嵌套 StateMachine 间交接且用相对路径 parameters
  • 技术美术或程序在查动画抖动、过渡卡在错误状态,要区分 advance condition 与 travel 及 auto_advance 误用
  • 离屏群演要降 AnimationTree 成本,想用 VisibleOnScreenNotifier 切换 hero/crowd 图根的复杂度管理