Reference

Troubleshooting

Common symptoms and what to check.

Symptom	What to check
No Animatica menu after install	Did you restart MotionBuilder? The menu is added at startup. Confirm the installer targeted your MoBu version, then relaunch.
Status pill stuck on `idle`	Local: is the MMCP server running and the URL correct? Click Test. Cloud: are you logged in? Check email/password and click Test Connection.
"Custom steps rejected" / a 422 error	Diffusion steps are capped at 500 server-side. Lower the value or use the Fine (500) preset.
Constraint isn't respected	Raise CFG weight (constraint). Confirm the pin is on the intended frame (use `[`/`]`). Very high pin counts get a soft warning and may be capped.
Feet slide	Pin the planted foot with a Left/Right Leg constraint on the sliding frames and raise CFG weight (constraint). Leave Server post-processing on (Advanced). There is no client-side foot control — the old Foot cleanup checkbox never affected the applied result and was removed.
Motion is off the ground / floating	Use Create Ground and set the ground height (with Apply ground offset on), and/or enable Preserve height in Placement. A constant ~2 cm float on a canonical rig is the server's measured offset — turn on Correct ground offset in Settings → Extra options (canonical rigs only; pinned poses shift down by the same amount). On a single-block regeneration, Preserve height is ignored — keep Keep start pose checked instead.
Frames/constraints shift after generating	Enable Match scene FPS in Settings → Extra options so keys land 1:1 at your scene rate.
Bake did nothing	Baking needs an HIK character and is a no-op in Story mode. Check the Skeleton card's HIK status.
Something failed silently	Open the Console, read the last error, and Copy it. For deep issues, enable Settings → Debug to capture request/response JSON.