Use the expression function

[Last updated: 09/04/2019]

This page describes the procedure for regenerating facial expressions on Cubism models using Expression.
The following assumes that the “SDK has been imported”, “UpdateController has been configured”, and “ParameterStore has been set up” before being added to the project.



To play back facial expressions in Live2D Cubism SDK for Unity by .exp3.json, use the “Expression” component.

If the model was imported with “Live2D/Cubism/OrignalWorkflow/Should Import As Original Workflow” checkbox in the Unity Editor menu,
the Prefab generated will be set to Expression.

To set Expression on a Prefab that is not generated by the OW method, perform the following three steps.

  1. Attach CubismExpressionController
  2. Set “[model name].expressionList”
  3. Set the facial expression to be played



1. Attach CubismExpressionController

Attach “CubismExpressionController” to the GameObject that will be the root of the model.

CubismExpressionController has two configuration items.

  • Expression List: Set “model name.expressionList”    * Details are explained in step 2
  • Current Expression Index: Set the index of the expression to be played back    * Details are explained in step 3 of the procedure


2. Set “modelName.expressionList”

Select the model and drag and drop “[model name].expressionList” from the Inspector view into the “Expression List” of the CubismExpressionController.

* “[model name].expressionList” is a list of “.exp3” assets.
* The “.exp” asset is the asset where Expression data is stored. The “.exp3.json” is automatically generated when imported.


3. Set the facial expression to be played

Set the index of the expression to be played to “Current Expression Index” in CubismExpressionController. This time, set to 0.

This completes the setup for playback of facial expressions using the exp3 asset generated from exp3.json.

When Scene is executed in this state, the expression number 0 in “[model name].expressionList” will be played.
By resetting the “Current Expression Index,” you can switch the expression to be played back.

* If an index other than “[model name].expressionList” is set, the default expression will be played.

© 2010 - 2022 Live2D Inc.