River Mcsconverter by erikvdb - 1

Importers & Exporters

Converter for MCS Avatar System in Unity 2019+

Unknown VersionMIT LicenseUpdated 41 days agoCreated on November 21st, 2019
Go to source

MCS Converter

This converter remaps the morphs of the MCS avatar system (v1.7) so they will work with Unity 2019 and later.

The issue.

Unity introduced a new way of optimizing mesh on import, which scrambles the vertex order of the MCS models. However, the MCS morph targets will still have the old vertex order, so when applying a morph the wrong vertices get pushed and you end up with some abstract art. On top of that, morph data for the JCTTransition component, which controls joint offsets for every morph, is being parsed incorrectly. This tool converts the morph target maps to their new vertex order, and can replace the new JCTTransition morph data with the old, in case you are using an unpatched MCS_Importer.dll

More information on the issues of MCS in Unity 2019 and other fixes can be found in this thread the Unity forums: https://forum.unity.com/threads/released-morph-character-system-mcs-male-and-female.355675.


  1. Create TWO Unity projects: one in version that works with MCS 1.7 (i.e. 2017 or <2018.4), and one in your later version (2019+). Apply the following steps to both projects.
  2. From https://github.com/mcs-sdk/mcs/releases, download and import your MCS packages. The CodeAndShaders.unitypackage and the female or male base package are mandatory; add whatever additional clothing/hair packs you have and need.
  3. Import the MCSConverter.unitypackage included in this repo, or drag and drop the RadboudVR folder into your Assets folder.
  4. Drag the MCSFemale or MCSMale prefab into your scene.
  5. Attach your content packs
  6. Add the ConvertMCS.cs component to the MCS character.

Convert MCS component


In your Unity 2017/2018 project:

  1. Select the meshes you wish to convert (default selects all)
  2. Click “Extract”. This will extract vertex maps of all selected models into a file folder.
  3. (Optional) Click “Export JCT”. This will export the JCTTransition morph data.
  4. Copy the extracted maps folder (Assets/MCS/ConversionMaps) and the JCT file (Assets/MCS/Resources) into the same location in your Unity 2019+ project.

In your Unity 2019+ project:

  1. Select all meshes you wish to convert.
  2. Click “Convert”. This may take a while and will overwrite the old morph streamingasset files.
  3. Restart Unity.


The JCTTransition component will reimport its morph data incorrectly every time you reopen the Unity project, hit play, or create a build. To solve, patch the MCS_Importer.dll (see https://github.com/erikvdb/mcs/commit/02fac8dc6fa6a2dd14db8b4a2119d21324990d5b), or else keep the Convert MCS component attached to your characters and the jctmorphs.json file in the Resources folder to overwrite the jcts during runtime.


I don’t see any morphs when I adjust the sliders apart from the very first one. Make sure GPU Skinning is turned OFF in player options.

I’m getting build errors saying “Assembly UnityEditor is referenced in MCS_Importer” Select MCS_Importer.dll and under Select platforms for plugin, only include Editor.

Show all projects by erikvdb