Data for Embedded Use

Updated: 02/02/2023

This section describes how to output models and motion files for games and other embedded applications.

Types of Embedded Data

The data for embedded use is output from the cmo3 and can3 files, respectively, as follows.

	Extension	Description
1	.png	The image set in the texture atlas is exported.
2	.moc3	Actual data of Live2D models for use in applications.
3	.model3.json	The model3.json file is in JSON format and contains information for linking moc3 files, texture files, etc. By using model3.json when specifying models in the SDK’s sample1 or After Effects plug-ins, you do not need to specify texture files yourself.
4	.physics3.json	This data contains the set values for physical operations.
5	.userdata3.json	This data contains the set values of user data.
6	.cdi3.json	This data contains information for parameters and part names and linkage information for parameters.
7	.motion3.json	This data contains motion data for each scene set in Animator.

Export Files for Embedded Use

Exporting moc3 files

Before exporting, please display the parts you need and hide the parts you do not need.

When exporting a moc3 file, the first step is to edit the texture atlas.
See “Edit Texture Atlas” for more information.

When you have finished editing the texture atlas, with the models to be exported displayed, click on the [File] menu -> [Export Embedded File] -> [Export as moc3 file].

When the [Export Settings] dialog box appears, confirm each setting and click [OK].
Note: For the export target, select [1/1] to export the texture in its original size.

moc file export (for 2.1)

This is a feature of the Cubism 3 version only.
With the Modeling View displayed, configure the settings and click [OK] to execute.

Export Physics settings

The physics settings file is often exported together with the moc3 file when it is exported, but it can also be exported separately.
Select [File] menu -> [Export Embedded File] -> [Export Physics settings].
Export the physics settings file (.physics3.json), specifying the save location.

For FPS information:
If the FPS information is not set in the model file, the information dialog box is displayed and the FPS information is not written out.

If the FPS information is set in the model file, a confirmation dialog box will appear and FPS information will be exported only if [Yes] is selected.

How to set FPS information:
FPS information is set by opening “Physics and Scene Blend Settings” in the model file.
Model files created with Cubism Editor 4.1.01 or earlier may not have FPS information set.

Exporting motion files

With the animation file selected, configure the settings and click [OK] to execute.
It will be written out as a .motion3.json file.

Motion Export Settings

Motion can be selected and exported as desired from the motion export settings.
In the [Motion Export] section of the inspector palette, with the checkbox checked, click the “Gear” button to display the Settings window.

The [Motion Export Settings] dialog box appears.
You can freely select the motion you want to export using the checkboxes.
After making your selection, click [OK].

Output scenes with motion export enabled

Open the [Motion Data Settings] dialog box by following the steps below.
Click [File] menu -> [Export Embedded File] -> [Export motion file].

Select [Output scenes with motion export enabled] in the Export Scene Settings and click [OK].

The motion selected in the [Motion Export Settings] dialog box was exported to the specified destination.

Loading Files for Embedding

Motion files exported for embedding can be imported back into Animator.

How to import:

1. Select a scene
2. Right-click on the part of the track name (1) of the model for which you want to import motion
3. Click Motion Load (2)
4. Select the target motion3.json file

Note: It may take some time when loading motion.