mocopi Receiver Plugin for Maya

mocopi Receiver Plugin for Maya is a plugin for receiving motion data transmitted from the mocopi app and applying it to 3D characters in Maya 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 Maya plugin, you can easily apply captured motion data to 3D characters and skeletons in your Maya scenes.

Key Features

• Real-time Motion Capture: Directly receive motion data from mocopi app via UDP
• Maya Integration: Apply motion data to Maya character rigs with automatic bone mapping
• Cross-Platform Support: Works on Windows and macOS
• Easy Integration: Simple Maya device node setup for quick configuration and customization

Supported Platforms

Requirements

Development Environment

Windows

• Maya: Maya 2022 or later (2022-2026 supported)
• Visual Studio: Visual Studio 2019 or later with C++ support
• CMake: CMake 3.5 or later
• Maya DevKit: Maya Developer Kit for your Maya version
• Windows SDK: Windows 10 SDK or later
• Network: Local network connection between mocopi app and Maya application

macOS

• Maya: Maya 2022 or later (2022-2026 supported)
• Xcode: Xcode 12 or later with command line tools
• CMake: CMake 3.5 or later
• Maya DevKit: Maya Developer Kit for your Maya version
• macOS SDK: Included with Xcode
• Network: Local network connection between mocopi app and Maya application

Runtime Requirements

• mocopi app (Mobile version: Android/iOS, or PC version: Windows)
• UDP communication connection between mocopi app and Maya application
• Maximum motion data frame rate: Depends on mocopi app settings

Installation and Building

Prerequisites

1. Maya DevKit: Download and install the Maya DevKit for your Maya version from Autodesk Developer Network
2. CMake: Install CMake 3.5 or later
3. Compiler:
   • Windows: Visual Studio 2019 or later with C++ support
   • macOS: Xcode 12 or later with command line tools

Building the Plugin

1. Clone this repository

2. Navigate to the plugin directory

3. Configure DevKit location (required):

   The build scripts expect the Maya DevKit to be installed in specific locations. Default paths are:

   Windows: C:\MayaDevKit\<version>\devkitBase
   macOS: /Users/<username>/MayaDevKits/<version>

   If your DevKit is installed elsewhere, modify the build script:

   Windows (buildWin.bat)

   Edit line 11:

   set DEVKIT_BASE_PATH=C:\MayaDevKit

   Change to your DevKit base path.

   macOS (buildMac.sh)

   Edit lines 10-12:

   USERNAME="username"
   DEVKIT_BASE_PATH="/Users/$USERNAME/MayaDevKits"

   Change USERNAME and DEVKIT_BASE_PATH to your setup.

4. Run the appropriate build script for your platform:

Windows

buildWin.bat

macOS

chmod +x buildMac.sh
./buildMac.sh

Alternatively, you can build manually using CMake:

mkdir build
cd build
cmake -DDEVKIT_LOCATION="path/to/maya/devkit" ..
cmake --build . --config Release

This will create the plugin binary (.mll on Windows, .bundle on macOS).

Installing to Maya

1. Copy the built plugin to Maya's user plugin directory:

   • User plugin directory: ~/maya/<version>/plug-ins/

2. Copy the .mod file to Maya's user module directory:

   • User module directory: ~/maya/<version>/modules/

3. Start Maya and load the plugin through:

   • Window > Settings/Preferences > Plug-in Manager
   • Find "MocopiMayaPlugin" and check "Loaded"

Quick Start

For detailed setup instructions and usage guide, please refer to the official documentation:

Maya mocopi Plugin Usage Guide: https://www.sony.co.jp/en/Products/mocopi-dev/jp/documents/ReceiverPlugin/Maya/MoveActor.html

This guide provides comprehensive information on:

• Basic plugin usage
• Creating and configuring mocopi device nodes
• Connecting to character rigs
• Network setup
• Troubleshooting

Plugin Structure

The plugin consists of the following main components:

Core Classes

• MocopiDeviceNode: Maya dependency graph node that receives and processes mocopi motion data
• MocopiDataHandler: Handles UDP communication and data parsing from mocopi app
• MocopiMotionFormat: Defines the motion data format and bone mapping
• MocopiDidCharacterizeCmd: Maya command for character setup and bone mapping

Key Features

• Real-time UDP communication with mocopi app
• Automatic bone hierarchy detection and mapping
• Support for multiple Maya character rigs
• Japanese and English localization support
• Integration with Maya's dependency graph system

Troubleshooting

Common Issues

Q: Plugin fails to load in Maya

• Ensure you have the correct Maya version (2022-2026 supported)
• Verify that the Maya DevKit was used to compile the plugin
• Check that all required DLLs/libraries are accessible

Q: Motion data is not being received

• Verify that both devices are connected to the same network
• Check UDP port configuration (default: 12351)
• Confirm that the mocopi app is transmitting data
• Check Windows Firewall or macOS firewall settings

Q: Character movement appears jerky

• Check network latency and stability
• Verify frame rate settings in the mocopi app
• Consider adjusting Maya's playback frame rate
• Check for connection issues or packet loss

Q: Bone mapping is incorrect

• Use the provided characterization command to set up proper bone mapping
• Verify that your character rig follows standard naming conventions
• Check the SkeletonHelpers.mel script for mapping utilities

For additional troubleshooting, please see the FAQ.

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: Maya Plugin Guide
• Maya Developer Resources: Autodesk Maya Developer Help

Copyright © 2026 Sony Corporation. All rights reserved.