Troubleshooting
Messages/s stays at 0
- Check that the selected input mode matches your sender.
- Check the sender port against the value in the application.
- Allow the application through Windows Firewall on Private networks.
- Close another application that uses the same port, then restart the application.
The receiver does not move
- Check the output address and port.
- For a one-PC setup, use
127.0.0.1for output. - Check that the receiver accepts VMC input.
- Load the same VRM file in the receiver and in MocapSeitai.
The pose looks wrong
- Use Ghost or Side by side comparison in Display tab to see the difference from source motion.
- Realign. See Realign
- Check the actor measurements and the six Retarget adjustments.
- Make sure you use a separate settings for each avatar.
- Turn off experimental features.
Realign
Use the buttons in the upper-right corner when a rig needs a rebuild:
- Realign actor rig (source rig): Use this after you recalibrate the sender or switch its tracked model. MocapSeitai reads the incoming skeleton again and rebuilds the source baseline.
- Realign character rig: Use this when the loaded avatar still has an incorrect pose.
Hand anti-penetration gives an unwanted pose
Hand anti-penetration is experimental. It can change hand motion and cannot solve every fast motion or model shape.
- Set the mode to Off to confirm that the feature causes the result.
- Start again with Hybrid.
- Check the collider overlay and correct the collider fit if needed.
- Test the pose with Side by side comparison.
A saved tune does not load
The per-avatar sidecar map stores avatar tuning. It does not apply automatically to every model.
- Extract the application archive before you run it.
- Save the sidecar map after tuning.
- Load the matching sidecar map with the matching avatar.
Windows blocks the application
The build can show a SmartScreen warning because it is unsigned. Select More info, then select Run anyway if you trust the download source.
Send a useful bug report
Use Copy diagnostics, then paste the result into a bug report. Include the input mode, receiver app, avatar type, and steps that reproduce the problem.