Convert data up to Cubism 2.1 to Cubism 3 or later format

(Updated 10/26/2021)

Development of Cubism 2.1 has already been completed.
Data up to Cubism 2.1 is not compatible with Cubism 3 or later formats.
Therefore, to use with Cubism 3 or later SDKs, it must be converted to the latest method.

Cubism 3 or later editors can read Cubism 2.1 edit data.
Using this, data up to Cubism 2.1 can be loaded into Cubism 3 or later editors and exported as Cubism 3 or later format for use in the SDK.


Important point

  • To convert from Cubism 2.1 format to the current format, you will need Cubism 2.1 editing format files (.cmox, .canx).
    Files in formats for embedded use (.moc, .mtn) cannot be converted.
  • Cubism 2.1 .cmox format does not save layer information, etc., so .cmo3 generated from .cmox cannot be replaced by re-importing PSD textures.
  • Physics (.physics.json) and pose (.pose.json) cannot be diverted.
    If you want to use it with SDK, etc., you need to create it anew.
    See “How to Set Up Physics” for information on how to set up physics operations and “Pose Settings” for information on how to set up poses.
  • In Cubism 4.1.01 beta1 and earlier, when converting .canx to .can3, one frame is added at the end of every scene due to UI specifications.
    If you have problems with behavior when looping motion, etc., shrink one frame at the end of the addition to make the scene the same length as the .canx.
    Since Cubism 4.1.01 release version, the specification has been changed and the length of scenes will be the same after conversion to .can3.


Model Data Conversion

This section explains the procedure for converting .cmox to .cmo3 and .canx to .can3.

After converting to .cmo3 or .can3, you can add user data and events, export data for embedding, and work according to your normal workflow.
See “User Data and Events” for user data and events, and “Embedded Data” for export to embedded data.


Import the model data (.cmox) to be updated into the editor of Cubism 3 or later


When the import is complete, the model will appear in the Modeling View.

Check the shape set for the parameters and adjust if necessary

Deformer interpolation calculations differ between Cubism 2.1 and later and Cubism 3 and later.
Therefore, the updated model may lose the shape between the keys set in the parameters.
At this stage, check for any collapse of deformation and adjust if necessary.
Deformity collapse often occurs in areas of large deformity, such as the shoulders and XY of the body.

Conversion of ID formats for parameters, parts, etc. is also done at this stage.
The SDK for Cubism 3 or later does not support formats up to Cubism 2.1, so some features are not available.
Therefore, in order to take advantage of the SDK features, IDs must also be converted to Cubism 3 or later format.
See “ID Conversion” for details on ID format conversion.


Save in .cmo3 format

From the menu bar, press “File > Save” or Ctrl + S to save in .cmo3 format.


The specified destination folder will be opened. Check to see if the .cmo3 file exists.

This completes the conversion of model data.


The .idmap file is generated in the same hierarchy as the .cmox file, but this file contains ID information before and after the conversion.
If an ID format conversion is performed, the motion curves associated with the ID before conversion are reassigned using the information recorded in this file.

Model data conversion can also be performed from motion data conversion as described below.


Conversion of motion data (for motion and facial expressions)

Motion data for editing has a reference to the model data used in the scene, which must also be .cmo3.
If you converted the model data earlier, you can replace .cmox with .cmo3.
It is also possible to convert .cmox to .cmo3 and update the reference to .cmo3 from the “Convert Motion Data (for motion and facial expressions)” procedure.

* If the material data used in the motion, such as a rough sketch, is unlinked, it cannot be converted. (An error will occur.)
Open the .canx file in Cubism 2.1, delete the material with broken links, save it, and then convert it.


Import the motion data (.canx) to be updated into the Cubism editor for editing


Select the target version of the animation for your motion application and click the OK button.


When the import is complete, the scene will appear in the Animation View.

Update the model you are using

The procedure for updating the model used in the motion is different if the .cmo3 to be replaced already exists or if the .cmo3 does not yet exist.

A If .cmo3 already exists:

Right-click on .cmox in the project window and click “Replace Data”.

Select the .cmo3 to be replaced and click “Open”.

B If .cmo3 does not exist:

Double-click .cmox in the project window.

Cubism's Model screen will open, and the converted model will be displayed.

At this time, adjust the model if necessary.
For details, refer to “2. Check the shape set in the parameters and adjust if necessary”.


Check motion curves and adjust if necessary

Since the method of calculating motion curves is different between Cubism 2.1 and earlier and Cubism 3 and later, the curves are generated with approximate values when updating motions.
Check by replaying the motion, etc., and adjust the curve if necessary.



Adjust the number of frames in the scene (* only for motion for facial expressions)

The specification of curve information set for motion is different between Cubism 2.1 and Cubism 3 or later.
In Cubism 4.1.01 release version or later, a scene set to 1 frame in .canx will be set to 0 frames when converted to .can3.
* The 4.1.01 release version will include a fix for the problem of 1F being added to the end of the file.

In Cubism 3 or later, the scene for facial expression motion must have at least one frame.
Therefore, when converting .canx of motion for facial expressions to Cubism 4.1.01 release version or later editors, the number of frames in the scene must be adjusted after conversion.
For details on how to set the number of frames, see “Displaying and Operating the Timeline Palette#Basic Timeline Operations”.
* If you want to convert mainly motion for facial expressions, we recommend using an editor up to Cubism 4.1.01 beta1.


Save in .can3 format


This completes the conversion of the motion.

© 2010 - 2022 Live2D Inc.