在 Roblox 中处理 Humanoid/非…

适用于 Roblox 角色或模型动画系统的加载、播放控制、事件监听、优先级混合、默认动画替换及常见问题排查。

适用场景

解决思路

1. 使用核心对象模型：`Animation` 持有 `AnimationId`；`Animator` 位于 `Humanoid` 或 `AnimationController` 内并加载/驱动 track；`AnimationController` 替代非角色 rig 的 `Humanoid`；`AnimationTrack` 由 `LoadAnimation` 返回并控制播放。
2. 本地玩家角色动画：在 `StarterCharacterScripts` 中创建 `LocalScript` 来播放。
3. NPC 或服务器拥有的模型动画：在模型内部或 `ServerScriptService` 中创建 `Script` 来播放。
4. 不要用 `Script` 播放玩家角色动画，否则不会正确复制到本地客户端。
5. 在 `StarterCharacterScripts` 的 `LocalScript` 中，用 `local character = script.Parent` 获取角色；用 `local animator = character:WaitForChild("Humanoid"):WaitForChild("Animator")` 获取 `Animator`。
6. 用 `local animation = Instance.new("Animation")` 创建 `Animation`，并设置 `animation.AnimationId = "rbxassetid://1234567890"`。
7. 用 `local track = animator:LoadAnimation(animation)` 加载 `AnimationTrack`。
8. 用 `track:Play()` 播放，默认 fade-in 0.1s、weight 1、speed 1。
9. 用 `track:Play(0.1, 1, 0.5)` 指定 `fadeTime`、`weight`、`speed` 播放。
10. 播放中用 `track:AdjustSpeed(1.5)` 改变速度。
11. 播放中用 `track:AdjustWeight(0.5, 0.2)` 将权重调为 0.5、在 0.2s 内淡入。
12. 用 `track:Stop()` 停止，默认 fade-out 0.1s；用 `track:Stop(0.5)` 在 0.5s 内淡出。
13. 用 `track.Stopped:Connect(function() ... end)` 在淡出完成后执行逻辑，例如打印 “Animation finished”。
14. 用 `track.Stopped:Once(function() cleanup() end)` 做一次性清理。
15. 在 Roblox Animation Editor 中设置命名 keyframe marker；用 `track:GetMarkerReachedSignal("FootStep"):Connect(function(paramString) playFootstepSound() end)` 在到达 marker 时触发。
16. 在 Animation Editor 的 loop toggle 中设置动画是 `Looped = true` 还是 `Looped = false`；运行时可用 `track.Looped = false` 或 `track.Looped = true` 覆盖。
17. 对循环动画，不要依赖自动停止；需要时调用 `track:Stop()`。
18. 对一次性动画，它会在一个周期后自动停止。
19. 让循环动画只播放一次：设置 `track.Looped = false`，调用 `track:Play()`，再用 `track.Stopped:Once(function() print("Done") end)` 监听结束。
20. 用优先级决定争夺同一关节的 track 谁生效；优先级顺序为 `Idle < Movement < Action < Action2 < Action3 < Action4 < Core`，更高者覆盖更低者。
21. 设置 `idleTrack.Priority = Enum.AnimationPriority.Idle`、`runTrack.Priority = Enum.AnimationPriority.Movement`、`attackTrack.Priority = Enum.AnimationPriority.Action`。
22. 先 `idleTrack:Play()`；再 `runTrack:Play()` 覆盖共享关节的 idle；再 `attackTrack:Play()` 在其拥有的关节上叠加混合。
23. 当两个 track 优先级相同时，用 weight 调整影响：`trackA:Play(0, 0.6)`（weight 0.6），`trackB:Play(0, 0.4)`（weight 0.4），在共享关节上混合。
24. 对 Humanoid：用 `local animator = character:FindFirstChildOfClass("Humanoid"):FindFirstChildOfClass("Animator")`，再 `local track = animator:LoadAnimation(animation)`，然后 `track:Play()`。
25. 对 AnimationController：用 `local controller = model:FindFirstChildOfClass("AnimationController")` 获取控制器；用 `local animator = controller:FindFirstChildOfClass("Animator")` 获取 Animator；若不存在则 `animator = Instance.new("Animator")` 并设置 `animator.Parent = controller`；再 `local track = animator:LoadAnimation(animation)` 并 `track:Play()`。
26. 替换默认角色动画时，修改角色内 `Animate` LocalScript 持有的动画引用；在 CharacterAdded 时修改其 `AnimationId` 值。
27. 在 `StarterCharacterScripts` 的 `LocalScript` 中，用 `local animate = script.Parent:WaitForChild("Animate")` 获取 `Animate`。
28. 定义 `replaceAnim(slotName, newId)`：`local slot = animate:FindFirstChild(slotName)`；若存在，`local animObj = slot:FindFirstChildOfClass("Animation")`；若 `animObj` 存在，设置 `animObj.AnimationId = newId`。
29. 调用 `replaceAnim` 替换槽位，例如 `replaceAnim("idle", "rbxassetid://111111111")`、`replaceAnim("run", "rbxassetid://222222222")`、`replaceAnim("jump", "rbxassetid://333333333")`、`replaceAnim("fall", "rbxassetid://444444444")`、`replaceAnim("climb", "rbxassetid://555555555")`。
30. 可替换的槽位包括：`idle`、`walk`、`run`、`jump`、`fall`、`climb`、`swim`、`swimidle`、`toolnone`、`toolslash`、`toollunge`。
31. 停止所有正在播放的动画：定义 `stopAll(animator, fadeTime)`，遍历 `animator:GetPlayingAnimationTracks()`，对每个 `track` 调用 `track:Stop(fadeTime or 0.1)`。
32. 用 `track:Play(fadeTime, weight, speed)` 控制播放参数：`fadeTime` 默认 0.1（淡入秒数）、`weight` 默认 1.0（关节影响 0–1）、`speed` 默认 1.0（播放速率）。
33. 用 `track.TimePosition` 读写当前播放位置（秒）。
34. 用 `track.Length` 读取总时长（秒）。
35. 用 `track.IsPlaying` 读取是否正在播放（布尔）。
36. 用 `track.Looped` 读写是否循环（运行时允许覆盖）。
37. 用 `track.Priority` 读写 `Enum.AnimationPriority`。
38. 用 `track.WeightCurrent` 读取当前实际混合权重。
39. 用 `track.WeightTarget` 读取淡入后的目标权重。
40. 做仅上半身动画时，在 Animation Editor 中只给上半身骨骼打关键帧，保持下半身关节未打关键帧；优先级混合会影响动画触及的所有关节，没有运行时 API 做关节遮罩，必须在动画资产层面解决。
41. 修正“在 `Script` 中播放角色动画”：改用 `StarterCharacterScripts` 中的 `LocalScript`。
42. 修正“在 `Humanoid` 上调用 `LoadAnimation`（已废弃）”：改为在 `Animator` 上调用。
43. 修正“两个动画在同一关节上冲突”：给它们分配不同的 `Priority` 值。
44. 修正“`Stopped` 立即触发”：检查动画长度是否为零或 `Looped` 设置是否错误。
45. 修正“`GetMarkerReachedSignal` 从不触发”：检查 marker 名称是否拼写错误，或添加 marker 后是否重新上传动画。
46. 修正“NPC 动画对其他客户端不可见”：改用服务器端 `Script` 播放，而不是 `LocalScript`。
47. 修正“`AnimationController` 的 track 无法播放”：确保 `AnimationController` 内有 `Animator` 子对象。

适用边界 · 注意事项

• 不适用于非 Roblox 引擎或非 Roblox 动画系统（如 Unity、Unreal、Godot）。
• 当需要运行时关节遮罩/仅上半身混合但动画资产未按上半身骨骼制作时，脚本无法解决，应改动画资产。
• 没有权限上传或引用 rbxassetid 动画资产时，无法按此流程播放自定义动画。