Other Languages

日本語

MeshSync

Working together with MeshSyncDCCPlugin, MeshSync is a package for synchronizing meshes/models editing in DCC tools into Unity in real time.
This allows devs to immediately see how things will look in-game while modelling.

Supported Platforms

Windows 64 bit
Mac
Linux

Basic usage

Create a server object by clicking this menu: GameObject -> MeshSync -> Create Server. This object has MeshSyncServer component that handles the sync process.

MeshSyncServer

Auto Start
On: automatically start the server using the specified port.
Off: click Start/Stop button manually to start/stop the server.

Caveat: in a public network, other users will have access to MeshSync as well when the server is running. For example: they may view our Unity screen.
Root Object
Designate an object to act as the root for object groups generated by synching. If empty, an object will be created in the root.
Sync Visibility, Sync Transform, etc.
A setting for enabling/disabling sync for individual components. This is useful for confirming the results precisely, such as the physics simulation behavior in Play mode without being overrided by the transform sync.
- If Update Mesh Colliders is enabled and the mesh has a MeshCollider, MeshCollider properties will also be updated when the mesh is updated.
Animation Interpolation
Sets the animation interpolation method. The default smooth interpolation will be fine in most cases, but for films it may be preferable to match the number of animation samples to the target framerate on the DCC side and disable interpolation by selecting "Constant".
Keyframe Reduction
Perform keyframe reduction when importing animations.
- Threshold: the error tolerance.
  The number of keys will decrease is the threshold increases, but the error will increase as well.
- Erase Flat Curves: delete curves that have no change (flat).
Z-Up Correction
This setting is related only to 3ds Max and Blender which coordinate system is Z-Up, and specifies how to convert Z-Up to Y-Up.
"Flip YZ" converts all vertices of Transform and Mesh to Y-up.
"Rotate X" converts the root object's Transform to a Y-up by applying a -90 X rotation to the root object, leaving the Mesh as a Z-up.
In many cases, "Flip YZ" is preferable. For reference, Unity's standard fbx Importer does the equivalent of "Rotate X".
Material List
MeshSyncServer and SceneCachePlayer maintain a list of materials.
Changing the materials in this list will apply the changes in the corresponding objects.
- If Sync Material List is enabled, changes in an object's material will be reflected in the material list and propagated to other objects with the same material.
- We can save and load the list with Import List, Export List.
  When updating the cache file, this can be used to carry over the materials.
Progressive Display
On: mid-reception scene updates will be reflected in real-time.
Off: updates will be reflected after all of the scene data is received.
Animation Tweak
Basic animation adjustments.
- Override Frame Rate: change the frame rate.
  Unlike Unity's standard "Set Sample Rate", only the frame rate changes, but not the key duration or the animation length.
  Playing a 24 FPS animation without interpolation in an environment of 60 FPS will cause jittery movements. In this case, a possible option would be to change the animation to 120 FPS to mitigate it.
- Time Scale: perform time scaling.
  For example, applying 0.5 will double the speed.
  - Offset adds an offset for the specified seconds.
    For example, applying a scale of -1 and an offset of -5 to a 5 second animation will result in reverse playback.
- Drop Keyframes: drop keyframes.
  If we apply Step=2 to an animation with 30 keystrokes, then the odd frames will be removed and the animation will become 15 frames.
  Similarly, if Step=3, then the animation will become 10 frames.
Make Asset
Meshes which are created by editing in DCC tools are objects that only exist in the scene where they are created. In order to use them in other scenes or projects, we can save them as asset files by clicking the "Export Mesh "button.

Advanced Features

SceneCache

Tips

Starting from Unity 2019, a maximum of 255 bones can be used, allowing MeshSync to sync models that require a lot of bones, such as facial animations. See Quality Settings-Blend Weights for more detail.
The sync process is done via TCP/IP, so Unity and the DCC tool can be located on separate machines.
To set up this connection, go to the client DCC tool's Server/Port setting and designate the machine running Unity.
When there is a MeshSyncServer object in the scene in Unity, we can open the server's address:port in our browser to view the server's Unity GameView via the browser (the default is 127.0.0.1:8080).
If a message is sent from the browser's message form, that message will appear in Unity's Console. This communication method can be useful when Unity and the DCC tool are being used by different people.
If only the pose/animation are being edited, we recommend disabling Sync Meshes in MeshSyncServer component, which can make the performance lighter.

Caveats

When MeshSyncServer runs, it will automatically copy required MeshSync assets to StreamingAssets/MeshSyncServerRoot.
Please keep them as they are.
Although this package is designed to be used in the Editor, model syncing will still work in runtime as well, but not the animations.
For performance reasons, make sure that the syncing is not executed in the final build, unless it is required.
It is possible to use this package in Unity 2018 and earlier, but bear in mind that the maximum number of bones per vertex is 4 in these earlier versions of Unity.
If the model is using too many bones, the model won't sync correctly.

peterliuf/MeshSync