Skip to main content
Version: Next (dev)

Upgrading Animation to 0.12

PlasmaEngine 0.12 fixes several animation behaviours that 0.11 got wrong. Existing skeletons, clips and graphs load without changes, but some of them now play differently. This page lists what you may notice after upgrading a project and what to do about it.

Transform the animation graphs​

Animation graphs must be transformed again with 0.12. The asset document version changed, so the next Transform All Assets (Ctrl+Shift+E) picks them up automatically. An animation graph cooked by an older version does not load in 0.12.

Skeletons and animation clips do not need a re-cook: older cooks are still read.

What plays differently​

ChangeWhat you seeWhat to do
State machine transitions and nested graphs are exportedGraphs with authored transitions now leave their initial state. Before, they never transitioned.Nothing; transform the graph.
State machine states blend their own poseTransitions crossfade instead of snapping or outputting nothing.Nothing.
Lerp, Layer and Switch nodes take more than six posesPoses past the sixth now take part instead of being dropped.Check graphs that connect more than six poses.
BlendSpace 1D clamps its parameterParameter values outside the authored range hold the end sample.Nothing.
Event tracks sort at loadEvents at the same time always fire in authored order.Nothing.
Humanoid retargeting converts between body framesRigs that are not Y-up/+Z-forward, or whose source and target axes differ, now retarget correctly. Y-up rigs facing the same way are unchanged.Check retargeted clips. See the legacy switch below.
Hip height and hip translation use the body's up axisHip bob and crouch on Z-up rigs are no longer scaled by a near-zero height.Same as above.
Avatars that fail validation no longer retargetShared joints, a broken hierarchy, degenerate body frames or mirrored scales give a validation error instead of a distorted pose.Fix the mapping on the skeleton asset's Humanoid tab.
Auto Map no longer picks root as HipsOnly affects pressing Auto Map again. Stored mappings are untouched.Review the result before saving.

Humanoid retarget legacy switch​

If a retargeted character looks wrong after upgrading and you need the 0.11 result back while you investigate, two cvars help:

CVarDefaultDescription
Animation.HumanoidRetarget.LegacyoffUses the 0.11 retarget solve: world-space deltas, and hip height and hip split along world +Y. Validation is the same in both modes.
Animation.HumanoidRetarget.CompareLegacyoffRuns both solves for every retargeted sample and logs one warning for each clip, target and source whose result differs by more than 1 degree on a mapped joint or 0.01 units at the hips.

A CompareLegacy warning looks like this:

Humanoid retarget result changed since 0.11.1: clip='...', target='...', source='...', maxRotation=37.2 degrees on 'LeftUpperArm', hipOffset=0.412. ...

Use it to find the clips worth checking: play your scenes with CompareLegacy on, then look at each reported clip in the editor. Most reports on Z-up or differently oriented rigs are the intended fix.

warning

Both cvars are temporary. They are planned to be removed in 0.13.0, so fix the content rather than shipping with Legacy on.

If cooked output still looks stale​

Nothing deletes caches automatically.

  1. Close the editor and any running player.
  2. Reopen the project and run Transform All Assets (Ctrl+Shift+E).
  3. Still wrong? With the editor closed, delete the project's AssetCache folder, then reopen the project and run Transform All Assets again. Source assets and project settings are not affected, but the full transform takes time.

See Also​