Panel reference
Settings
Card 00 — connection, story path, naming, and global options, grouped into sub-sections.
Connection and global options, grouped into sub-sections. The header pill shows connection status. Most groups have their own Reset.
#Connection
| Control | Description |
|---|---|
| Backend | Toggle between Local and Cloud (api.animatica.ai). The panel below swaps to match. |
| Server URL (Local) | Address of your MMCP server. Default http://localhost:8000. Test checks reachability. Reset here restores only the URL — it never wipes credentials or flips the backend. |
| Email / Password (Cloud) | Your Animatica credentials. Log In / Log Out, plus Test Connection. Your account tier appears as a pill. The password is held only in the field, never saved to disk. |
#Story & Naming
| Control | Description |
|---|---|
| Story Export Path | Folder where exported FBX clips are written when you generate in Story mode. Browse to pick it. |
| Auto take-name length | How many leading characters of the prompt seed an auto-generated take name (1–120, default 50). |
#Non-canonical rigs
Collapsed by default — only needed when driving your own (non-plugin) skeleton.
| Control | Description |
|---|---|
| Skip top joint when sending hierarchy | On by default. Skips a synthetic Reference/Root null above the hips so the next joint (usually Hips) is treated as the character root. |
| Compensate group scale + Group scale | When your rig sits under a uniformly scaled null, divides wire offsets on send and multiplies them back on apply so geometry stays correct. |
#Extra options
| Control | Description |
|---|---|
| Match scene FPS | On by default. Keys generated motion frame-for-frame at the scene FPS so authored frames & constraints stay 1:1. Off = key at the model's native 30 fps (real-time pace, but frames may shift). A no-op when the scene is already 30 fps. |
| Send path heading (face along path) | On by default. Derives a body facing from each Path waypoint and sends it to the server so the character turns to face its direction of travel. May over-constrain sharp turns — compare with it off. |
| Send real body context with hand/foot pins | Experimental, off by default. Sends the rig's real pelvis position and facing alongside every hand/foot pin that has no Path or Full Body pin on its frame. Off, the server approximates the body from a T-pose around each pin — which can push the torso away from where you posed it; on, the pelvis is also pinned, which constrains the trajectory more. Compare both on your shot. |
| Path waypoint wins over same-frame hand/foot pins | Off by default: when a Path waypoint shares a frame with a hand/foot pin, the pin wins — it snaps almost exactly onto its target, but the body is free to ignore the waypoint on that frame and may jump to reach the pin. On: the waypoint wins — your authored body position is honoured and motion stays natural, but the pin lands near (not exactly onto) its target. The choice is deterministic either way; the order you created the markers in never matters. |
| Correct ground offset | Off by default. The server returns motion floating a measured ~2 cm above the ground; this subtracts that measured amount from the applied root height so the planted foot lands on the plane. Canonical-skeleton generations only (a custom/retargeted rig is skipped, with a Console note). Trade-off: Full Body pinned poses land lower than their authored scene height by the same amount. |
#Interface
| Control | Description |
|---|---|
| Show Motion Import panel | Reveals card 02 · Motion Import (hidden by default for the generation-first workflow). |
| Open Animatica on MotionBuilder startup | Auto-opens the tool once when MoBu finishes loading. |
#Debug
Collapsed by default.
| Control | Description |
|---|---|
| Save request / response JSON + Debug folder | Writes request.json / response.json / motion.json / meta.json per run so a misbehaving session can be diffed against a known-good one. Default folder: ~\Documents\MB\Animatica_Debug. |
| Omit timing block | Experiment — drops the FPS block from the request; the server may default its FPS or reject. |
| Omit frame-0 root anchor | Experiment — suppresses the implicit root_path anchor the tool injects at frame 0. That anchor keeps generated motion from drifting off its start point; leave this off unless you are deliberately pinning frame 0 yourself. |
| Send effector rotations | Probe lever — adds each hand/foot pin's captured local quaternion (rotations) to its effector_target wire. Ignored by the hosted server (measured no-op); consumed only by a local kimodo_server. A pin dragged after capture ships the rotation captured before the drag, with a warning — recreate the pin to refresh it. |
A read-only reference of the timeline's full interaction vocabulary lives at the bottom of Settings. The complete tables are reproduced under Keyboard & mouse.