MotionBuilder Live Sync

Setup Guide

Install & Configure
Setup guide for MotionBuilder Live Sync For Unity, covering installation and receiver configuration.
The trial edition supports up to 1 character and 2 props. For more, the Unlimited edition is required.

Install MotionBuilder Pluginlink

  1. Download the plugin from theDownload page.
  2. Quit MotionBuilder if it is running.
  3. Unzip the downloaded file.
  4. Copy the plugin (MoBuLiveSyncTool.dll) that matches your MotionBuilder version to the plugin folder.
Example for MotionBuilder 2023: copy 2023\MoBuLiveSyncTool.dll to C:\Program Files\Autodesk\MotionBuilder 2023\bin\x64\plugins.

Import MotionBuilder Pluginlink

  1. Open the Asset Browser tab in the Resources window.
  2. Click Templates > Devices.
  3. Drag "LiveSyncDevice" into the scene.
  4. Check Navigator > Devices to confirm the import.
Plugin import

Install the Unity Receiverlink

Install the Unity receiver library from theDownload page or from GitHub .

1. Install via Unity Package Manager

Add the URL from the GitHub README to Package Manager.

https://github.com/nasshu2916/MotionBuilder-Live-Sync-Unity.git?path=/Assets/MoBuLiveSync
Unity Package Manager

2. Install manually

Clone the repository and add Assets/MoBuLiveSync to your Unity project.

MotionBuilder Plugin Setuplink

Characters Tab

Configure the characters you want to sync.
Characters must have matching bone rotation offsets between MotionBuilder and Unity. It is recommended to use FBX exported from Unity's FBX Exporter in MotionBuilder.

Add a Character

Drag a characterized Character from Navigator > Characters onto the table header to add it.
Add character
  1. "Remove" deletes the selected character.
  2. "Clear All" removes all characters.
  3. "Refresh" updates the list and adds all characterized characters.
  4. "Root Name" shows the character name.
  5. "Subject Name" is the identifier used in Unity. It can be edited by double-click.
  6. "Send" toggles data transmission.
Subject Name must be unique on the Unity side. Duplicates between Characters and Props are allowed.
Character table

Props Tab

Configure the props you want to sync.

Add a Prop

Drag a scene node from Navigator > Scene onto the table header.

Add prop
  1. "Remove" deletes the selected prop.
  2. "Clear All" removes all props.
  3. "Refresh" updates the list.
  4. "Root Name" shows the prop name.
  5. "Subject Name" is the identifier used in Unity.
  6. "Send" toggles data transmission.
Subject Name must be unique on the Unity side. Duplicates between Characters and Props are allowed.
Prop table

General Tab

Configure global settings.

  1. "Sample Rate" sets the sampling rate (default 60).
  2. "Address" shows the destination IP address and port.
  3. "Add" adds a destination.
    ※ Enter IP address and port in the format [IP address:port].
  4. "Remove" deletes the selected destination.
  5. "Change" edits the selected destination.
  6. "Store" saves the destination list to the PC.
  7. "Load" loads a saved destination list.
  8. The language can be switched from the dropdown.
General tab

Start / Stop Synclink

Press "Online" to start or stop syncing. A green button indicates active transmission.

① shows packet rate, ② shows packet size.

Send settings

Additional Featureslink

Save / Load in FBX

Include the device in FBX to save and load the following settings:

  • Characters settings
  • Props settings
  • Destination address settings

Unity Setuplink

Add Receiver

  1. Add the MoBuLiveSyncReceiver.prefab from Asset/MoBuLiveSync/Prefabs to the Scene, or add MoBuLiveSyncManager.cs to a GameObject.
  2. Set the receive port (default: 49000) in the Inspector.
  3. Toggle "Is Enable Receiver" to enable/disable receiving.

While playing, the Inspector shows packet size, sampling rate, and subject names.

Unity manager

Character Setup

Add LiveSyncCharacter.cs or use MBSync > Add Sync Character.

Add character menu

Configure the following in the Inspector.

  • Assign the Receiver to Live Sync Manager.
  • Set Subject Name to match MotionBuilder.
  • Toggle Is Enable Sync.
  • Assign the Animator.
Unity character
Using the menu auto-fills some fields.
Characters must use Humanoid animation type and matching mapping.
If using VRM, export with FBX Exporter and use the FBX in MotionBuilder.

Prop Setup

Add LiveSyncProp.cs or use MBSync > Add Sync Prop.

  • Assign the Receiver to Live Sync Manager.
  • Set Subject Name to match MotionBuilder.
  • Toggle Is Enable Sync.
Unity prop
Using the menu auto-fills some fields.