Converting Live2D Avatars from Facerig to Animaze

Our goal for the Animaze launch is for the users who want to import Live2D models optimized for FaceRig to have very little work to do in the Animaze Editor, except loading and sending the Live2D Facerig Avatar to Animaze. 

Legacy Inputs 

If you have a Live2D avatar that you used to load in FaceRig, you will be able to load the same data pack in the Animaze Editor, and then you can export it as a Live2D Avatar to the Animaze App (on PC or iOS). 

The only exception to that rule is if your Live2D runtime model is older than Cubism 3.0 (launched spring, 2017). If your Live2D runtime model is made with Cubism 2.x, you will have to re-export it from Cubism as ver. 3.0 or later. To do that you will need access to the Live2D model source files and the Cubism Editor.

Expressions (Exp3) support 

Live2D Motions were named Special Actions in FaceRig;

Live2D Expressions were named Special Poses in FaceRig. 

This is the same naming convention we use in Animaze.

Motions (Special Actions) already import and work directly, as they did in Facerig.

Expressions (Special Poses) in FaceRig were not done via the new exp3 files, but rather they were defined manually in the config files; that is why they don't import directly from config files just yet (we are working on it though, the Animaze editor will auto-generate the correct exp3 files for them).

Expressions in Animaze do however import directly right now, if they are present as exp3 in the Live2D model.

The guide below outlines the steps you need to take to convert a custom Live2D avatar designed for Facerig to be compatible with Animaze. After you complete the conversion process, we recommend familiarizing yourself with the Animaze documentation. In particular, you will want to have the Editor User Manual, Create your own 2D avatar, and Getting Started with 2D Avatars close by so you can import your converted Live2D character into the Animaze Editor (and, of course, to Animaze!).


If you have a Live2D Model built with Cubism 3.0 or higher and your model does not have any Expressions/Special Poses, you can import your Live2D model into the Animaze Editor as is, with no changes. You don’t need to complete any of the steps in this guide.

If you have a Live2D Model built with Cubism 3.0 or higher and this model does have Expression/Special Poses, you only need to complete Step 3 in the instructions below.

If you have a Live2D model that was built with Cubism < 3.0 (i.e. 2.1), you need to follow all the steps below, unless it does not have Expressions/Special Poses, in which case you can skip Step 3.

Step 1: Open Your Live2D Model in the Latest Version of Cubism 

Open your Live2D model in the latest version of Cubism. Cubism will automatically convert your model to be compatible with the latest Cubism version. 

Once you open the model in the latest Cubism editor, it may prompt you with a message similar to the below:


Step 2: Update Motion Parameter Naming Conventions in Cubism

Animaze uses slightly different naming conventions than Facerig for many Live2D motion parameters. To ensure your Live2D character will function properly as an Animaze avatar, you must update the following Motion Parameter Naming Conventions. 

Do this in the Cubism Editor by running this function: Menu Modeling > Convert Model ID 

Note that ranges/intervals for the animation inputs aren't restricted. Animation inputs of Cubism models can be any duration. Animaze will handle the animation interval correctly.

Step 3: Re-Export Special Poses as exp3 files.

**This step is only required if your Live2D avatar utilizes Special Poses. If your model does not utilize these Cubism features, you can proceed to Step 4.**

If your old Live2D avatar for FaceRig had special poses, you need to re-export these as exp3 files from the Cubism editor. Animaze will then look for *.exp3.json files and import them as Special Poses. In the future the Animaze Editor will do this for you (for old avatars that had their special poses defined in the old config files, the Animaze Editor will parse those config files and generate the exp3 files automatically so you will not need to open up the Cubism Editor and do this step, but for now you will have to do it).

Motions need no extra care: they will work automatically: Animaze will look for *.motion3.json files in the /motions/ folder of the model file directory. 

There is no need to update naming conventions for Special Actions and Special Poses.

Step 4: Export Updated Cubism Files in *.JSON format

In Cubism editor go to File, choose Export For Runtime and select Export as moc3 file.

This action will generate the *.JSON files needed to import your model in Animaze. 

Congratulations! You have successfully updated your Live2D character to make it compatible with Animaze!

Step 5: Import your Live2D avatar in the Animaze Editor

Now it is time to import your Live2D character into the Animaze Editor! To do this, first download the free Animaze Editor and follow the steps in our import guide:

Create the .avatar bundles ready to use in the Aimaze apps (PC&mobile).

©2020, Animaze, Inc. and the Animaze logo are registered and/or unregistered trademarks of Holotech Studios Inc.