AnimaticaMotion Builder Docs
← OverviewProtocolGet started

Getting started

Installation

Install the plugin with the per-user installer, or run in place from a source checkout.

  1. Download animatica-setup-<version>.exe from the latest release.
  2. Double-click it and click Next through the wizard. It runs per-user (no admin prompt), installs to %LOCALAPPDATA%\Programs\AnimaticaToMoBu, and lets you choose which detected MotionBuilder versions to target.
  3. Restart MotionBuilder. A top-level Animatica menu appears in the main menu bar. Choose Animatica → Open Animatica Tool… to launch the window.

The installer registers in Add/Remove Programs as "Animatica to MotionBuilder." Uninstalling there removes the copied files, the per-version module manifests, and the launchers.

#Developers / in-place install

To run from a source checkout (so editing code doesn't require reinstalling), use one of the in-place installers. Each writes a .mod module manifest into every detected Documents\MB\<year>\config\ that points back at your checkout.

  • Double-click scripts\install.bat (or scripts\install.vbs), or
  • Open MotionBuilder's Python Editor and run:
exec(open(r"...\animatica_to_mobu\scripts\install.py").read())

Then restart MotionBuilder and pick Animatica → Open Animatica Tool…. The tool is also registered as a standard MoBu tool, so it can be opened from Open Reality → Python Tools.

⚠ Shared module note — The exe installer and the in-place installer write the same per-version .mod file — last writer wins. Running the in-place installer after an exe install repoints the module at your checkout; the exe's uninstaller still removes whichever .mod is present.

#The Animatica menu

Once installed, a top-level Animatica menu sits in MotionBuilder's main menu bar.

ItemWhat it does
Open Animatica Tool…Opens (or re-focuses) the main tool window.
Settings…Opens the separate Animatica Settings window — the same card described under Settings.
Load Example Prompt…Lists the example prompt files that ship with the plugin; the chosen file's prompt blocks are inserted at the playhead and any blocks already on the timeline are kept. The chooser is modeless — MotionBuilder's viewport and timeline stay live while it is open, so you can scrub to the frame you want to insert at without closing it. The folder is rescanned on every open, so files you drop in appear without restarting MoBu.
User Manual…Opens the manual in your default browser.
About Animatica to MoBuVersion and short description.

#Opening from the Python Editor

import animatica_to_mobu
animatica_to_mobu.show_ui()   # opens the dock window