Docs / Reference / Troubleshooting
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. |
| Create Skeleton: "already holds a … rig" | The namespace is taken by a different rig — usually one built for another model. Set Namespace to the name the message suggests and press Create again, or delete the rig that is there. |
| Console: "Model '…' is not served here" | The server does not advertise the model selected in Text to Motion; the first model it does advertise was used instead. Pick a served model from the dropdown (it is populated from the server), or point the tool at a server that has yours. |
| Console: "No retargeting available" | Your rig does not match the selected model and no route can reconcile them: Settings → Retarget route is None, or it is Auto and neither the server nor HIK can do it. Pick a route, build the model's own rig (Skeleton → Create), or pick a model whose skeleton matches this rig. |
| A hand/foot pin makes the request fail on a retargeted rig | On the server-retarget route, pins are checked against the model's canonical joint names. A pin on a joint the model does not know is rejected outright (a Full Body pose only loses those joints, with a warning). Pin a joint the model knows, or generate on the model's own rig. |
| Older build: "skip_root requires…" on Generate, or "Adopt failed — bind-pose capture" | Both came from Skip top joint being applied to a rig rooted at Hips, which has several joint children. The setting is now ignored on such rigs, so generating on a foreign rig and adopting a Hips-rooted rig both work — update the plugin. |
| Something failed silently | Open the Console, read the last error, and Copy it. For deep issues, enable Settings → Debug to capture request/response JSON. |