Skip to main content

Debugging Animation Graphs

Live graph debugging​

While a scene plays or simulates in the editor, the animation graph window shows what the graph does for one character, live, on the graph itself:

  • States: the active state of every state machine is highlighted, with its blend weight and time. During a transition, the state machine shows Current > Next NN%, and the transition wire flows and carries the transition's progress in percent.
  • Pose wires flow while their source contributes to the pose, and are labelled with the source's blend weight when it is below 1.
  • Number, bool and trigger wires carry the value of the pin they end in: a number, true/false, or fired for a trigger.
  • Nodes show what they do this frame, for example the weight and time of a playing clip, the blend space position and clip weights, or which pose a Pose Switch selects.
  • Parameters panel: the Live column shows each blackboard parameter's value on the debugged character. - means the character's blackboard does not have that entry.
  • Animation Clips panel: the status line names the debugged character, its state and the transition that runs.

Nodes in a state that does not contribute are drawn as inactive. When no update has arrived from the game for 1.5 seconds, the status turns Stale and the graph keeps the last values, with the wires no longer flowing.

Choosing the character​

  1. Open the animation graph asset in its own window.
  2. Play or simulate the scene that uses the graph.
  3. Select a character in the scene whose Animation Controller Component runs this graph. The graph window follows the selection; with nothing selected, it shows the first character that runs the graph.

The Debug Source menu of the graph window chooses the character explicitly:

EntryBehaviour
Follow Selection (first character if none)The default. Follows the character selected in the scene.
Preview CharacterShows the graph window's own preview character instead of the game.
A character's namePins that character, whatever is selected. The menu lists the characters of the running game that use this graph, and how many more are not listed.

Only one graph window per game is debugged at a time. If another graph window has taken over, picking a Debug Source in this window takes it back.

Status messages​

MessageMeaning
Game not runningPlay or simulate the scene.
No character selected: ...Select a character that runs this graph, or pick one from Debug Source. The message says how many characters run it.
Character destroyed: ...The debugged character is gone. The last snapshot stays visible.
The graph changed since the game started: run it againThe graph was edited after the game loaded it. Stop and play again.
This graph was exported by an older version: transform the asset againTransform the animation graph asset, then play again.
Another animation graph is being debugged. ...Pick a Debug Source in this window to take over.

Checking a graph step by step​

Start with a named Sample Clip connected directly to Pose Result. Verify that the graph's clip mapping resolves to a compatible clip, then add blending and conditions one at a time.

  • Check the editor's Log for missing resources and invalid blackboard entries.
  • Verify that Pose Result receives a pose and has a nonzero target weight.
  • Check that a connected In Start receives a trigger; an unconnected In Start on Sample Clip starts automatically.
  • Verify indices, input types, and exact clip and blackboard names. The Parameters panel's Refs column shows how many nodes use each parameter.
  • For missing events, check the event handler and object hierarchy.
  • For deformation errors, check the skeleton and clip compatibility.

The current source does not register the older Log, Log Info, or Log Error animation nodes. Use live graph debugging, the editor log and gameplay-side diagnostics when investigating graph inputs and events.

See Also​