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. |
| A control I used yesterday is gone | The window is in Compact layout. Flip the Compact / Full switch in the header (or Animatica → Toggle Compact / Full Layout). Nothing was reset — the hint under Generate Motion lists any hidden option that is off its default. See Compact & Full layout. |
| No Console, Settings or Motion Import card in the window | They are windows of their own now — Animatica → Open Console…, Settings…, Open Motion Import…. Each docks like a native MotionBuilder panel. Show Motion Import panel in Settings does not govern this in MotionBuilder. |
| Console: "Backward travel … walks facing away from its travel on frames A–B" | The character walks part of the clip backwards. Cheapest first: regenerate on another seed; soften the turn on the Path or give it more frames; try Send real body context with hand/foot pins in Settings → Extra options — it helped on some scenes, not all, and costs pin accuracy. |
| Generate fails on a retargeted rig with "Times must be in strictly increasing order" | An older build sent two Full Body poses on the start frame — your pin and the tool's own start anchor. Since 1.1 the anchor stands aside for a pin the user already set; update the plugin. |
| Console: "Model '…' is not served here" | The server does not advertise the model selected in the Model card; 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. |