mocopi Receiver Plugin for Unity is a plugin for receiving motion data transmitted from the mocopi app and applying it to 3D avatars in Unity in real-time.
- 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)
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 Unity plugin, you can easily apply captured motion data to 3D avatars in your Unity applications.
- Real-time Motion Capture: Directly receive motion data from mocopi app via UDP
- Avatar Integration: Apply motion data to Unity avatars with automatic bone mapping
- Cross-Platform Support: Works on Windows, macOS, Android, and iOS
- Easy Integration: Simple APIs for quick setup and customization
| Platform | Supported Versions |
|---|---|
| Windows | Windows 10/11 |
| macOS | macOS 10.15+ |
| Android | Android 11+ |
| iOS | iOS 15.7+ |
Note: Linux is not currently supported.
- Unity: Unity 6000.0.60f1 or later
- Network: Local network connection between mocopi app and Unity application
- mocopi app (Mobile version: Android/iOS, or PC version: Windows)
- UDP communication connection between mocopi app and Unity application
- Maximum motion data frame rate: Depends on mocopi app settings
- Download the latest release from Releases
- Extract the package to your Unity project's
Packagesdirectory - Unity will automatically import the package
- Drag & drop a humanoid avatar model file (FBX format, etc.) into
Assets- To use the sample model, please use
Assets/MocopiReceiver/Samples/ReceiverSample/Models/MocopiAvatar.fbx
- To use the sample model, please use
- Select the model asset and click the Rig tab in the Inspector
- Set the following items and click the
Applybutton:- Animation Type: Humanoid
- Avatar Definition: Create From This Model
- Click the
Configure...button to check bone mapping - Drag & drop the model asset into the Hierarchy window
- Select the avatar object and add
Mocopi AvatarfromAdd Component
- Drag & drop the following Prefab into the Hierarchy window:
Assets/MocopiReceiver/Resources/Prefab/MocopiSimpleReceiver.prefab - Select the Receiver object and expand
Mocopi Simple Receiver (Script)in the Inspector - Open
Avatar Settingsand click the+button - Set the following in
Element 0:- Mocopi Avatar: Drag & drop the Avatar object from Hierarchy
- Port: UDP communication port number with mocopi app (default: 12351)
Please ensure that the smartphone running the mocopi app and your Unity application are connected to the same local network. The plugin communicates via UDP on port 12351 by default.
This repository includes sample scenes demonstrating basic usage:
- Basic Receiver Sample: Shows fundamental setup and avatar control
- Advanced Integration: Demonstrates custom bone mapping and data processing
To check the samples, please refer to Assets/MocopiReceiver/Samples/.
Q: Motion data is not being received
- Please verify that both devices are connected to the same network
- Please check UDP port configuration (default: 12351)
- Please confirm that the mocopi app is transmitting data
Q: Avatar movement appears jerky
- Please check network latency and stability
- Please verify frame rate settings in the mocopi app
- Please consider implementing motion smoothing
For additional troubleshooting, please see the FAQ.
For technical support and questions, please join the following Discord server:
Discord: https://discord.gg/k55wY45y5N
- mocopi Official Developer Site: https://sony.net/mocopi-dev/
- Documentation: Unity Plugin Guide
Copyright © 2025 Sony Corporation. All rights reserved.