Live2D Model Requirements & Motion Parameter List

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. 

 

FaceRig

Animaze

Head movement

PARAM_ANGLE_X

ParamAngleX - for right to left twist movement.

PARAM_ANGLE_Y

ParamAngleY - for down to up movement.

PARAM_ANGLE_Z

ParamAngleZ - for right to left lean movement.

Body movement

PARAM_BODY_ANGLE_X

ParamBodyAngleX - for right to left twist movement.

PARAM_BODY_ANGLE_Y

ParamBodyAngleY - for down to up movement.

PARAM_BODY_ANGLE_Z

ParamBodyAngleZ - for right to left lean movement.

PARAM_BREATH

ParamBreath - for breathing movement.

Eyes movement

PARAM_EYE_BALL_X

ParamEyeBallX - for right to left movement.

PARAM_EYE_BALL_Y

ParamEyeBallY - for down to up movement.

PARAM_EYE_L_OPEN

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.

PARAM_EYE_R_OPEN

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.

PARAM_EYE_FORM

ParamEyeBallForm - bends eyes contour to complement frown expression.

Eyebrows movement

PARAM_BROW_L_Y

ParamBrowLY - for left eyebrow down to up movement.

PARAM_BROW_R_Y

ParamBrowRX - for right eyebrow down to up movement.

PARAM_BROW_L_ANGLE

ParamBrowLAngle - for left eyebrow tilting movement.

PARAM_BROW_L_DEFORM

ParamBrowLForm - for left eyebrow changing shape movement.

PARAM_BROW_R_ANGLE

ParamBrowRAngle - for right eyebrow tilting movement.

PARAM_BROW_R_DEFORM

ParamBrowRForm - for right eyebrow changing shape movement.

Mouth movement

PARAM_MOUTH_OPEN_Y

ParamMouthOpenY - for mouth closed to open movement.

PARAM_MOUTH_FORM

ParamMouthForm - for sad to smile movement.

PARAM_MOUTH_SIZE

ParamMouthSize - for pursed lips movement


The Animaze Retargeting System normalizes all values (interval 0 to 1) before applying the Live2D parameters so that the parameter ranges can be of any values. E.G. ParamMouthOpenY can be defined from -10 to 10 with default value 0, so when Animaze sets 0.75 - which is a half smile -, it will apply the value 5 to the ParamMouthOpenY parameter.

Having this said, we do suggest the following ranges for the Live2D Parameters:

Item

Minimum values

Default values

Maximum values

ParamEyeLOpen

ParamEyeROpen

0

0.75

1

ParamEyeBallX ParamEyeBallY

-1

0

1

ParamBrowLY 

-1

0

1

ParamBrowLX

-1

0

1

ParamBrowLAngle ParamBrowRAngle

0

0.5

1

(*)ParamBrowLForm

(*)ParamBrowRForm

0.2

0.5

0.8

ParamMouthForm

-1

0.5

1

ParamMouthOpenY

0

0

1

(*)ParamMouthSize

-1

0

1

Set your avatar's parameters properly

Set your avatar's parameters properly

Set your avatar's parameters properly

(*)ParamMouthSize is a non-standard Live2D parameter that is optionally used by Animaze for puckered lips movement. 

The default size of the mouth is considered at the middle of the parameter range, shrinking the mouth when going down to the lowest end, and growing the mouth when going to the highest end. 

Animaze only uses the first half of the interval, low to middle. Concrete values for the interval are suggested, but not mandatory, to be -1 and 1, where 0 means default mouth size.

(*)The values for ParamBrowLForm & ParamBrowRForm in the table make the eyebrows deform as intended with the current tracking system.

Set your avatar's parameters properly

Additionally, you can check the standard cubism parameter list AT THIS LINK and AT THIS LINK.

Below we detail how to convert old parameters into ones that Animaze uses:

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

Live2D parameters setting

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

  • Export the files for Runtime:

Live2D avatar parameters setting

Set your Live2D avatar's parameters properly

To create an idle animation for the 2D avatar, you must create a loopable animation by moving the selected parameters, where the avatar is in a generic position (usually it’s a breathing animation). The first and last animation frames must be identical. 

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.

 

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