mocopi Receiver Plugin for MotionBuilder

mocopi Receiver Plugin for MotionBuilder is a plugin for receiving motion data transmitted from the mocopi app and applying it to 3D avatars in Autodesk MotionBuilder in real-time.

License Notice

• This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
• Notwithstanding the foregoing, this repository does not include the mocopi logo or application icons. Use of these assets requires entering into a separate mocopi Logo and Icon License Agreement. (here)

Overview

mocopi is a motion capture system that captures full-body motion data using a smartphone app or PC app combined with mocopi sensors. By using this MotionBuilder plugin, you can easily apply captured motion data to 3D avatars in your MotionBuilder projects.

Key Features

• Real-time Motion Capture: Directly receive motion data from mocopi app via UDP
• Motion Recording: Record motion data directly into MotionBuilder takes
• Multi-Version Support: Supports multiple MotionBuilder versions (2024-2026)
• Easy Setup: Simple plugin installation and device configuration

Supported Platforms

Platform	Supported Versions
Windows	Windows 10/11

Supported MotionBuilder Versions

Version	Support Status
MotionBuilder 2023	✅ Supported
MotionBuilder 2024	✅ Supported
MotionBuilder 2025	✅ Supported
MotionBuilder 2026	✅ Supported

Requirements

Development Environment

• MotionBuilder: Any supported version (2023-2026)
• Visual Studio: Visual Studio 2019 or later
• Network: Local network connection between mocopi app and MotionBuilder application

Runtime Requirements

• mocopi app (Mobile version: Android/iOS, or PC version: Windows)
• UDP communication connection between mocopi app and MotionBuilder application
• MotionBuilder installation with plugin properly deployed

Installation and Building

Building the Plugin

1. Setup Development Environment

   • Copy MotionBuilder SDK lib and include folders from your MotionBuilder installation to the corresponding version folder:

     "C:\Program Files\Autodesk\MotionBuilder 20XX\OpenRealitySDK\lib"     -> "mb20XX/lib"
     "C:\Program Files\Autodesk\MotionBuilder 20XX\OpenRealitySDK\include" -> "mb20XX/include"
     

2. Build the Plugin

   • Open ordevice_mocopi.sln in Visual Studio
   • Select the appropriate configuration for your MotionBuilder version
   • Build the solution in Release mode

Installing the Plugin

1. Deploy Plugin Files

   • Copy the following DLL files to your MotionBuilder plugins directory:
     • mocopi_plugin_mb.dll
     • mocopi_motion_serializer.dll

   Example installation path:

   C:\Program Files\Autodesk\MotionBuilder 2023\bin\x64\plugins
   

2. Restart MotionBuilder

   • After copying the files, restart MotionBuilder to load the plugin

Quick Start

1. Plugin Setup

1. Add mocopi Device to Scene

   • In Asset Browser, navigate to Templates > Devices
   • Add mocopi plugin to your scene

2. Create Avatar Skeleton

   • In Navigator, go to Model binding
   • Click Create to generate the mocopi skeleton

3. Configure Network Settings

   • Set the UDP port number for receiving data (each avatar should use a different port)
   • Default port: 12351

2. Receiving Motion Data

1. Start Connection

   • Click Online to start listening for mocopi data
   • The plugin will enter connection waiting state

2. Connect mocopi App

   • Launch mocopi app on your smartphone
   • Go to motion recording screen
   • Start Motion Transmission to send data to MotionBuilder
   • Motion data will be received and applied to the skeleton in real-time

3. Recalibration

   • When performing recalibration in the mocopi app, turn Online OFF and then ON again

3. Recording Motion Data

You can record motion data directly into MotionBuilder takes:

1. Check the Recording checkbox
2. Click the record button
3. Choose whether to create a new take or overwrite the current take
4. Click the play button to start recording, click again to stop
5. Uncheck Live and play back to review the recorded data

Project Structure

ReceiverPluginForMotionBuilder/
├── src/                              # Source code files
│   ├── ordevice_mocopi_device.cxx   # Main device implementation
│   ├── ordevice_mocopi_hardware.cxx # Hardware interface
│   ├── ordevice_mocopi_layout.cxx   # UI layout
│   └── mocopi_motion_serializer_bridge.cpp # Motion data bridge
├── bin/                              # Built binaries for each MB version
├── dll_build/                        # DLL dependencies
├── obj/                              # Object files
├── mb20XX/                           # MotionBuilder SDK folders
└── ordevice_mocopi_mb20XX.vcxproj   # Visual Studio project files

Troubleshooting

Common Issues

Q: Motion data is not being received

• Verify that both devices are connected to the same network
• Check UDP port configuration and ensure no firewall blocking
• Confirm that the mocopi app is transmitting data
• Make sure the plugin is in "Online" state

Q: Avatar movement appears jerky or delayed

• Check network latency and stability
• Verify frame rate settings in the mocopi app
• Consider network optimization

Q: Plugin doesn't appear in MotionBuilder

• Ensure both DLL files are copied to the correct plugins folder
• Restart MotionBuilder after plugin installation
• Check that you're using a supported MotionBuilder version

Q: Skeleton creation fails

• Ensure the mocopi device is properly added to the scene
• Check MotionBuilder console for error messages
• Verify plugin dependencies are installed

Support

For technical support and questions, please join the following Discord server:

Discord: https://discord.gg/k55wY45y5N

Resources

• mocopi Official Developer Site: https://sony.net/mocopi-dev/
• Documentation: MotionBuilder Plugin Guide

---

Copyright © 2026 Sony Corporation. All rights reserved.