Docs / Panel reference / Settings
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. Ignored when the top joint has several joint children (a rig rooted at Hips). |
| Retarget route | How a rig that does not match the selected model is reconciled with it. Auto — server if it can, else HIK (default): the server retargets when it reports a retarget model (a server too old to report is still tried), otherwise the HIK route, and if neither is available the generation is refused. Server — send my rig, server retargets: your rig's hierarchy goes with the request and the motion comes back on its own joint names. HIK — generate on the model's rig, drive mine: the tool builds the model's own rig, characterizes both, and your rig follows through HumanIK. None — leave my rig alone: nothing is retargeted; the action stops with a Console error instead. |
| 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. |
When the route is consulted — Only when the scene rig and the selected model disagree. A rig that already matches needs no route at all: the request goes out on the canonical skeleton and the motion maps back onto your rig by name, with no retarget step. Generate Motion, Generate Selected Prompt, the gapped group fan-out and Generate Pose at Current Frame all ask the same question, so None stops all four. The HIK route belongs to Generate Motion alone — the other three say so in the Console and send the rig to the server instead. Picking a route explicitly also skips the automatic fallbacks: a model that cannot retarget falls back to HIK only under Auto.
#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.