Converting Live2D Avatars from Facerig to Animaze

Animaze makes it easy to turn almost any Live2D model into a fully-functioning avatar in a few simple steps. If you have a Live2D model that you would like to use as an Animaze avatar, this guide will tell you how to do it. This guide is appropriate for all Live2D models, including models that you may have used as avatars in FaceRig!

Remember, Live2D is included in all versions of Animaze by default - there is no need for a DLC to use Live2D characters. Download Animaze for free here!

NOTE: We have updated this documentation to reflect new improvements made to Animaze that make importing Live2D models much simpler. The old instructions that used to live on this page have been redacted, as they are no longer accurate.

Live2D Model Requirements & File Structure:

To work with Animaze, your Live2D model must be created with the Live2D Cubism Editor version 3.0 or higher. Cubism 3.0 was released in Spring 2017, so if your model was created after, it is very likely to meet this requirement. 

If your model was created with a version of Live2D Cubism lower than 3.0, you need to load the model’s Live2D source files in the Live2D Cubism Editor v3.0 or higher and re-export the Live2D runtime files. 

To ensure your Live2D character will function properly as an Animaze avatar, you must update the following Motion Parameter Naming Conventions.

Motion Parameter List

The below table lists every Motion Parameter Naming Convention from Facerig that you will need to update for Animaze. If your model uses any of the Motion Parameter Naming Conventions listed in the ‘Facerig’ column, you will need to update the naming convention for those parameters to their corresponding value for Animaze. 




Head movement


ParamAngleX - for right to left twist movement.


ParamAngleY - for down to up movement.


ParamAngleZ - for right to left lean movement.

Body movement


ParamBodyAngleX - for right to left twist movement.


ParamBodyAngleY - for down to up movement.


ParamBodyAngleZ - for right to left lean movement.


ParamBreath - for breathing movement.

Eyes movement


ParamEyeBallX - for right to left movement.


ParamEyeBallY - for down to up movement.


ParamEyeLOpen - for closed to open left eye movement. The default value for this input is used as eye completely open; going to max value, the eye wide open expression is remapped, while min value to default value is the normal eye close motion.


ParamEyeROpen - for closed to open right eye movement. The default value for this input is used as eye completely open; going to max value the eye wide open expression is remapped, while min value to default value is the normal eye close motion.


ParamEyeBallForm - bends eyes contour to complement frown expression.

Eyebrows movement


ParamBrowLY - for left eyebrow down to up movement.


ParamBrowRX - for right eyebrow down to up movement.


ParamBrowLAngle - for left eyebrow tilting movement.


ParamBrowLForm - for left eyebrow changing shape movement.


ParamBrowRAngle - for right eyebrow tilting movement.


ParamBrowRForm - for right eyebrow changing shape movement.

Mouth movement


ParamMouthOpenY - for mouth closed to open movement.


ParamMouthForm - for sad to smile movement.

For example, if your Live2D Character utilizes the PARAM_ANGLE_X Motion Parameter, you’ll need to rename that Parameter to “ParamAngleX” to ensure it is compatible with Animaze. This conversion can be made within the Cubism Editor: 

  • In the Modeling Menu, go to Convert Model ID

Learn how to use Animaze by Facerig

  • A pop up will appear showing the conversion files. Choose the format 3.0 or later and click OK.

Learn how to use Animaze by Facerig

  • Export the files for Runtime:

Learn how to use Animaze by Facerig

Learn how to use Animaze by Facerig

To import your Live2D model into Animaze, you need your model’s Live2D Runtime files. They should be organized in the standard folder hierarchy

 Additionally, your model3.json file and .moc3 file must use the same filename (e.g. ‘myavatar.moc3 and ‘myavatar.model3.json’). If they have different filenames, Animaze may fail to import all of your model’s files.

Step 1: Import Your Model in the Animaze App 

The simplest way to import any Live2D model (including one you used with FaceRig) into Animaze is through Animaze’s built in Live2D Import feature.

Simply open Animaze, click on the “Import” Section of the top menu bar, and select ‘import Live2D Avatar’

Learn how to use Animaze by Facerig

When the file browser opens, navigate to your Live2D model’s folder, select your avatar’s ‘model3.json’ file and click ‘open’

Your avatar will appear in Animaze!

Learn how to use Animaze by Facerig

Important: If you are using the free version of Animaze (i.e. you have not purchased an Animaze subscription), importing your model will cost $.99. 

This is a one time fee for your model. As long as you do not change the filename of the avatar’s model3.json file or .moc3 file, you can update, edit, and change this avatar and re-import it as many times as you want - you only need to pay the import fee once. 

If you are an Animaze subscriber, unlimited free imports are included as part of your subscription.

Step 2: Test Your Avatar

Now that you’ve imported your avatar, you are free to use it in Animaze as you see fit! In most cases, Animaze will automatically import your model’s motion parameters, special actions, and special poses.

Make sure to test your avatar and ensure it is working as expected. If it does, you are all set, and don’t need to take anymore action. 

Congratulations on importing your Live2D Model to Animaze!

If You Need to Fix Your Avatar...

If your avatar isn’t behaving as expected, you’ll need to import the avatar into the Animaze Editor and try a few simple fixes. In the Animaze Editor, you can fix two common issues with Live2D avatars: blurry/low-res avatars, and certain face/body parts not responding to tracking input. 

[Link to Debugging Your Live2D Avatar]

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