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
| Change | What you see | What to do |
|---|---|---|
| State machine transitions and nested graphs are exported | Graphs with authored transitions now leave their initial state. Before, they never transitioned. | Nothing; transform the graph. |
| State machine states blend their own pose | Transitions crossfade instead of snapping or outputting nothing. | Nothing. |
| Lerp, Layer and Switch nodes take more than six poses | Poses past the sixth now take part instead of being dropped. | Check graphs that connect more than six poses. |
| BlendSpace 1D clamps its parameter | Parameter values outside the authored range hold the end sample. | Nothing. |
| Event tracks sort at load | Events at the same time always fire in authored order. | Nothing. |
| Humanoid retargeting converts between body frames | Rigs 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 axis | Hip 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 retarget | Shared 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 Hips | Only 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:
| CVar | Default | Description |
|---|---|---|
Animation.HumanoidRetarget.Legacy | off | Uses 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.CompareLegacy | off | Runs 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.
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.
- Close the editor and any running player.
- Reopen the project and run Transform All Assets (Ctrl+Shift+E).
- Still wrong? With the editor closed, delete the project's
AssetCachefolder, then reopen the project and run Transform All Assets again. Source assets and project settings are not affected, but the full transform takes time.