Docs / Reference / Troubleshooting
Troubleshooting
Seven symptoms and what to check for each.
| Symptom | What to check |
|---|---|
| The Animatica menu is not there after restarting Max | Run python scripts/install.py --list and check that the startup folder it prints matches the Max version and locale you are running — Max reads only its own language's profile tree. If no profile was detected at all, start Max once so it creates one, then install again. Then check the Max listener for the plugin's startup line: it names the folder this session loaded from and when that source was last edited. |
| "Local server unavailable" | The plugin could not reach your local MMCP server. The dialog offers three actions: Switch to Cloud, How to start the server (guidance only — Animatica never launches a server process for you), and Dismiss. See the note below before you conclude the server is down. |
| The generation was refused because of my rig | The server decides whether a retarget is needed. If it carries no retarget model and your rig does not match the model's canonical skeleton, the plugin refuses rather than generating something wrong. See the exact wording below. |
| Create Skeleton says joints are missing | A rig already exists under that namespace, and it does not carry every joint the selected model needs. Either change the Namespace so a separate rig is built, or delete the existing rig. |
| Constraint buttons do nothing | Capture needs a rig. With no skeleton created or picked, the Console shows a warning — create or pick one first. |
| The exported FBX reads wrong in another application | Export through File ▸ Export. The export hygiene rides on Max's export callbacks, so a rig exported any other way does not get it. If the Console or listener printed a line about transforms having moved or offsets not being restored after an export, that is the check reporting a real problem — note the joint names it printed. |
| A button in the window does nothing at all | Open the Console: most failures are logged there as a line rather than raised at you. The startup path also reports its own failures by name ("Failed to open the Animatica tool", "Failed to register the Animatica menu") followed by the traceback in the listener. |
#A busy local server looks like a dead one
The liveness probe waits five seconds. A single-worker local server that is in the middle of answering a generation cannot answer the probe within that window, so it is reported as unreachable even though it is running and working normally. Wait for the run to finish, then press Test in Settings.
#The refusal over a non-canonical rig is deliberate
It is not a failure to work around. When the server carries no retarget model and your rig is not the model's canonical skeleton, the plugin says so in these words:
this server does not support retargeting — use a rig that matches the model's canonical skeleton (Skeleton → Create), or a server with a retarget model
Two ways forward: press Create Skeleton and generate onto the canonical rig, or point the plugin at a server that has a retarget model.