◀ Previous: 10. Retarget Tab · 🏠 WC Animation Tools · Next: 12. Bone Profiles ▶


The Audit tab checks a whole folder of animations for common problems, then fixes them with a click. It's a health check for your animations.

Opening it

Tools > WC Animation Tools, then click the Audit tab at the top.

BMpgzhw6YI.png

Step by step: scan a folder

  1. In the Content Browser, open the folder with your animations.
  2. In the Audit tab, click Use Content Browser Folder. (Or type the folder into Folder.)
  3. Leave Recursive ticked to scan the folders inside it too.
  4. Click Scan. A progress bar shows while it works; you can cancel it.
  5. The findings appear in a list with three columns: Asset, Problem and Detail.
  6. For each finding:
  7. To fix every finding of one kind at once, click its Fix All: [kind] button.
  8. File > Save All when you're done.

<aside> ↩️

Fixes can be changed or undone. Any fix that changes the animation's keys is added as a step to the clip's own WC Animation Tools list and applied. Open the clip and you'll see the step there: change its settings, turn it off, or Revert.

</aside>

What it finds, and what Fix does

Problem What it means What Fix does
No Root Track The root bone has no animation track at all. Adds a Root Offset step that does nothing but write the root's track, and applies it.
Root Motion Off But Travels Enable Root Motion is off, but the root moves. In game the character would snap back. Turns Enable Root Motion on.
Root Motion On With No Travel Enable Root Motion is on, but the root barely moves. Turns Enable Root Motion off.
Root Scale Keys The root's scale isn't 1, so the character shrinks or grows. Adds a Root Offset step with Reset Root Scale ticked, and applies it.
Sliding Feet A planted foot drifts along the ground. The Detail says which foot and how far, for example The left foot drifts 5.3 cm while planted. Adds a Lock Feet step (using the Audit's Feet settings) and applies it.
Mixed Frame Rates This clip's frame rate differs from most of the folder. Adds a Resample step to the folder's most common rate, and applies it.
WC Animation Tools Not Applied The clip has a list that was never applied. Applies it.
Settings Changed Since Apply The clip's list was changed after it was applied. Applies it again.
Animation Changed After Apply The animation was changed (reimported, keyed by hand) after its list was applied. Applies the list again.
No Bone Profile The clip's skeleton has no Bone Profile. Makes one, fills it from the skeleton's preview mesh and lists it in Project Settings.

<aside> ℹ️

If a clip already has the step a fix would add (for example it already has Lock Feet), the fix doesn't add a second one. It tells you to change the existing step's settings in the clip's WC Animation Tools tab instead.

</aside>

The settings

These decide how strict the Audit is. The defaults suit most projects.

Setting What it does Default
Folder The folder of animations to scan.
Recursive Scan the folders inside it too. On
Slide Threshold A planted foot drifting further than this counts as sliding. 2 cm
Feet How planted feet are found. The same settings as Lock Feet (see 4. Root Motion Steps).
Travel Speed A root moving slower than this on average counts as not travelling. 10 cm/s
Turn Degrees A root that turns more than this over the clip is travelling (a turn on the spot), so it isn't listed as "no travel". 20°
Vertical Travel A root that moves up or down more than this is travelling (a climb or mantle), so it isn't listed as "no travel". 10 cm
Check Tools Status Also list clips whose WC Animation Tools list isn't applied, changed since, or whose animation changed after it. On

<aside> 💡

Too many sliding feet listed? Raise Slide Threshold to 3 or 4 cm and scan again. Fix All with a cancel part-way through keeps the ones it already fixed; the rest stay listed.

</aside>


◀ Previous: 10. Retarget Tab · 🏠 WC Animation Tools · Next: 12. Bone Profiles ▶