Skip to content

Live2D Editor - Manual

UI

Left: Operation Bar

Function Description
Background ■ Solid color: solid background colors
■ Image: custom background image
■ Disable: turn off background to save model snapshots without background
Scale Scale model
Rotate Rotate model
Save Scale and Position Write the current size and position into the Json config -> Option
Expression Switch expression
Show Hit Areas Show hit areas in red frame
Tips Operation tips
Information Moc model file information
Log Show model logs and display motion events
Render Size The resolution of the preview window
Snapshot Size The size of the snapshot image

Center: Model Preview

Icon Description
Edit json config
Edit model bounds
Preview models on the desktop
Save model snapshot

About Model Bounds

  • Model bounds define the range of mouse tracking and the range of click events that can be triggered
  • By default, the program automatically calculates the bounds by traversing all artmesh positions, but in some cases the calculated bounds may be too large or too small and need to manually adjust them on your own

Right: Tabs

File Inspector

  • Display model folders

    Icon Description
    Select Moc or Json file
    Select model folder
    Refresh
  • Display model related files

    • Click motion3.json to preview motions
    • Click exp3.json to preview expression
    • Click audio file to play audio
  • Other operations

    Operation Description
    Open Container Folder Open model file
    Create Config File Refer to:Create Json config files
    Create Json File From Facerig Config Refer to:https://www.bilibili.com/read/cv11482720

Config File

  • Display the content of Json config file

  • Other operations

    Operation Description
    Edit Edit Json file
    Repair motion files Attempted to fix some abnormal playback motion files. Validity cannot be guaranteed

Parameters

  • Displays all model parameter values

  • Other operations

    Operation Description
    Value Sync Parameter values are not refreshed in real time after closing it
    Reset All Resets all operations on parameter values
    Remove sort
    Ascend sort
    Descend sort

Parts

  • Display opacity of all parts of the model

  • Other operations

    Operation Description
    Value Sync Check the box and click on the model to display all the artmeshs of the clicked part
    Reset All Resets all operations on parameter values
    Remove sort
    Ascend sort
    Descend sort

Artmesh

  • Display opacity of all artmeshs of the model

  • Other operations

    Operation Description
    Free Select Parameter values are not refreshed in real time after closing it
    Reset All Resets all operations on parameter values
    Remove sort
    Ascend sort
    Descend sort

Json Editor

About Save and Close

  • "Save" will write the current config to the file and reload the model
  • "Close" only close the editor window and the model will not be reloaded

Common icons

Icon Description Icon Description
Add multiple items Copy
Add Remove
Move up Move down
Edit item name Select item

Template

Icon Description
Load template (insert item list)
Load template (replace item list)
Save template

Execution Sequence

Description Description
Restore saved parameter values and part opacity The data saved in the previous frame is restored at the beginning of each frame
Play motion file Play in layer order
Controller Execute controller code
Execution Command Execute Command code (if present)
Save parameter values and part opacity After saving, changes made to the data in the rest of this frame will not affect the data in the next frame
Execute physical files After execution, changes made to the data in the rest of the frame affect the physics

About the execution of the motion

  • By default, the program executes the idle motion in a loop, with all layers of motion executed simultaneously
  • After the motion is completed, another motion must interrupt the current motion (or stop the motion with the command [stop_mtn]), otherwise it will stop in the last frame of the motion
  • Based on the above two points, the layer with "idle" motion will return to the idle motion after the execution of other motions. When there is no hierarchy of "idle" motions, other motions will stop in the last frame after they have finished executing
  • Motions have a priority, and motions with a higher priority can interrupt motions with a lower priority. Motions of the same layer cannot be interrupted by default, unless【Interruptable】is checked in Motion Event Properties

Tips

  • Parameter drag has a priority, which affects the physical effect
  • Unmentioned Commands and controllers are executed as soon as conditions are met and do not participate in the execution of each frame
  • This sequence is by no means complete and is subject to change based on development needs

Version

Model versions


Textures

Model texture file

Tips

Textures must be arranged in the correct order, otherwise the model will display incorrectly


Hit Areas

Model trigger area, motion events can be triggered by the mouse

Item Description
Name Area name
ID Model artmesh ID
Sort When areas overlap, only the area with the highest serial number can receive mouse events
Motion When Clicked Triggered when the mouse clicks on the area
Motion When Entered Triggered when the mouse enters an area
Motion When Exited Triggered when the mouse leaves the area
Enabled Region is available or not

About artmesh visibility and area triggering

The artmesh that triggers the area association must have a visible part of it to trigger, not fully transparent or invisible. Check the artmesh visibility by dragging the slider on the artmesh list page and observing the artmesh changes


Motions

  • Motions consist of multiple motion groups, and each motion group can have multiple motions
  • Support to play motion groups of different layers at the same time, the layer is represented by [# layer number]
Example Description
Start Predefined motion group
TapHead Predefined motion group "Tap area name", where "Head" is the triggering area name
MyGroup Customized motion group name
MyGroup#3 Customized motion group name, motion group layer number is "3"

About multi-motion simultaneous playback

  • Motion playback has the concept of Layer. Motions at different layers can be played at the same time. Motions at the upper layer will overwrite motions with the same parameters at the lower layer
  • Motions are played at layer 0 by default. If you want to play at other layers, use the "motion group # layer" name format. For example, motion group "idle#1" indicates that the motion group is played at layer 1. Do not use motion "Group #0" when playing on layer 0. Use "Motion Group" directly.
  • Predefined Motion Group does not support layer except [Idle]. Please use [start_mtn] in the predefined motion to play motions at other layer.
  • Example as Simultaneous Playback in multiple motion groups

Predefined Motion Group

Event Description Note
Idle idle
Tap Mouse click If HitAreas exist, TapArea is preferentially triggered
TapArea Mouse click area HitAreas need to be configured,otherwise Tap events are used
Start Triggered when the model loads
Shake Triggered when the device is shaken Only for devices that support gravity sensing
Tick Triggers every minute
TickX(tick_x) Triggers every x minutes Fill in the number at X,,ranging from 1 to 60
An event is randomly selected to trigger, like Tick1 and Tick2 in minute 2
LeaveX_Y_Z(leave_x_y_z) Leave (No other event is triggered except idle) X indicates the start time, Y indicates the minimum trigger interval, and Z indicates the maximum trigger interval, in seconds
For example: Leave30_10_20 indicates that the Leave30_10_20 starts executing the event after 30 seconds. The triggering interval is between 10 and 20

Motion Properties

Basic Description Option Note
Name Motion name Motions can only be correctly identified by other referees after they have been named, otherwise only motion groups can be identified
Language The language of the motion ■ en:English
■ zhs:Simplified Chinese
■ zht:Chinese traditional
■ ja:Japanese
■ ru:Russian
Only can be triggered when the program is set to a language that matches the motion
File Motion file(motion3.json)
File Loop Check and the motion will be played in a loop
Text The text displayed when the motion is executed
Text Duration(ms) Duration of custom text display System will judge automatically when no set text duration
Text Delay(ms) Set the delay to start displaying text after the motion is played
Expression When the motion is played, fill in the expression name here
Sound The sound of an motion being played
Sound Channel Set the channel for playing the sound Select three channels (0,1,2), and the sound of different channels can be played at the same time. The default is 0
Sound Volume Sound volume
Sound Delay(ms) Set the delay for starting sound after an motion is played
Sound Loop Loop sound Often used to play background music
Blend Mode Used for mixing different layers of motion ■ Override
■ Additive
Blend Weight The weight of the current motion mixed with other motions
Fade In(ms) Motion fade in
Fade Out(ms) Motion fade out
Priority(2-9) Motion execution priority ■ The value can be set in the range of 2-9. The larger the value, the higher the priority
■ The default value is 2. If it is set to 9, the previous event is forcibly overwritten
Motion Duration(ms) Duration of a custom motion event After setting, the event is not affected by motions and voice duration
Weight Motion trigger probability The value ranges from 1 to 999. The larger the value is, the higher the trigger probability is. The default is 1
Speed Motion playback speed SDK 2 is unavailable. The default is 1
Advanced Description Option Note
Command Execute before the motion starts playing Available Commands
Post Command Execute after the motion is played Available Commands
Previous Motion Specifies the previous motion event The current motion can be executed only if the previous motion was set
Next Motion Specifies the next motion event The next motion to be performed after the motion is completed
Override Face Tracking Motions will not be affected by face capture
Enabled Motion events can be executed or not
Interruptable Motions can be interrupted or not ■ When checked, this motion event can be interrupted by motions of the same priority
■ This parameter is invalid for events of priority 9
Ignorable Motions can be ignored or not ■ Whether this event is allowed to be executed, when there is another motion event that meets the trigger condition and has a "Time limit" set
■ Setting "Time limit" will cause this parameter to be invalid
Time Limit The command can be executed only when the time condition is met ■ Hour/Minute/Month/Day
■ Duration(ms)
■ Birthday: the user’s birthday set in the program settings
Intimacy Only be executed when the intimacy is met ■ Minimum: Minimum intimacy required to trigger the event
■ Maximum: Maximum intimacy required to trigger the event
■ Equal to: When the intimacy is equal to this value
■ Bonus: The intimacy value increased by a successful trigger event
Special Description Option Note
Choices Performs an motion event by displaying a selection in a text box ■ Text
■ NextMtn:Next Motion
Float Variables The execution of the motion is controlled by float variables Condition
■ greater
■ greater_equal
■ lower
■ lower_equal
■ equal
■ not_equal

Value operation
■ assign
■ add
■ subtract
■ multiply
■ divide
■ init:initialize
■ A conditional manipulation is used to determine whether the motion event can be triggered
■ Value manipulation is used to manipulate values after an event is triggered
■ Two variables can be conditional and manipulated, for example: greater $var2 ($+ variable name)
■ The variable name can be the model parameter name preceded by @, for example, @paramanglex
■ Random number functions: RAND (min, Max) and RANDF (min, Max). Rand is an integer random;
Randf is floating point random; Min and Max Write the minimum and maximum values of random numbers
■ Variables can be archived
■ Init only works if the variable is not archived (uninitialized)

Float Variables

  • Float variables are of two types: Conditional and value manipulation
  • Conditional judgment: This motion event is allowed to execute only if a float variable meets a condition
  • Value manipulation: After the motion event is executed, the value of a float variable is manipulated

Reference to an motion

  • Motion reference format: "Motion Group: motion name"(for example: Tap:MotionA)
  • If only "Motion group" (for example, Tap) is written, any motion in this motion group that meets the condition is executed randomly
  • If "Motion Group": motion name is specified (for example, Tap:MotionA), the motion specified in the motion group is executed

Controllers

Mouse Tracking

Let the model follow the mouse to a certain degree of activity

Item attributes see as Common Item Attributes A

Item Description
Smooth Time The higher the smooth time, the slower the speed of the model following the mouse, and the higher the smoothness of the action

If the item list is empty, the Default Parameters load. The default parameter list is shown below

Default Parameters(SDK3) SDK2
ParamAngleX PARAM_ANGLE_X
ParamAngleY PARAM_ANGLE_Y
ParamAngleZ PARAM_ANGLE_Z
ParamEyeBallX PARAM_EYE_BALL_X
ParamEyeBallY PARAM_EYE_BALL_Y
ParamBodyAngleX PARAM_BODY_ANGLE_X

Lip Sync

Let the audio volume control the model's mouth opening and closing parameters

Item attributes see as Common Item Attributes A

Item Description
Gain The greater the gain, the more sensitive the mouth opening and closing is affected by the volume
Smooth Time The higher the smooth time, the slower the change of mouth opening and closing, and the higher the smoothness of the action

If the item list is empty, the Default Parameters load. The default parameter list is shown below

Default Parameters(SDK3) SDK2
ParamMouthOpenY PARAM_MOUTH_OPEN_Y

Tips

If there are key frames of control parameters in the motion, the controller may fail


Model automatic blink

Item attributes see as Common Item Attributes A

Item Description
Min Interval(ms) Minimum time between blinks
Max Interval(ms) Maximum time between blinks

If the item list is empty, the Default Parameters load. The default parameter list is shown below

Default Parameters(SDK3) SDK2
ParamEyeLOpen PARAM_EYE_L_OPEN
ParamEyeROpen PARAM_EYE_R_OPEN

Tips

If there are key frames of control parameters in the motion, the controller may fail


Param Hit

Control model parameters with mouse related operations

Item Description
Name Item name
ID The parameter ID
Hit Area Area that triggers drag
Type ■ Dragging: Hold down the left mouse button and drag
■ Stroking: Press the left mouse to move
■ Pressing: Long press the left mouse
Axis The XY axis of the mouse
Factor Multiplicator factor
■ Drag/stroke: Changes the value of each pixel of the mouse
■ Press: The parameter changes value for each 1 second press
Lock Param Parameters are not returned after releasing the mouse
Release(ms) Parameter value regression time after releasing the mouse
Release Type The animated curve of parameter regression
Weight The influence degree of parameter value on the model, namely actual influence value = parameter value x specific weight
Min Value Motion Trigger when parameter value reaches minimum
Max Value Motion Trigger when parameter value reaches maximum
Begin Motion Triggered when the left mouse is pressed
End Motion Trigger when the mouse is released (the maximum parameter has not been reached)
Low Priority Low priority items do not overwrite model physics
Enabled Whether the item is available

Param Loop

Parameters are played in a loop over time

Item Description
Min Interval(ms) Minimum time between loop
Max Interval(ms) Maximum time between loop
Time Sync Set parameter values based on the current system time

Param Value

Predefined param values that users can control

Item attributes see as Common Item Attributes B


Part Opacity

Predefined widget opacity allows users to control

Item attributes see as Common Item Attributes B


Artmesh Opacity

Predefined artmesh opacity allows users to control

Item attributes see as Common Item Attributes B


Artmesh Color

Predefined artmeshcolors that users can control

Item attributes see as Common Item Attributes B


Auto Breath

ParamBreath control the breath parameters of the model


Extra Motion

Random motions add on top of model motions

Default Parameters(SDK3) SDK2
ParamAngleX PARAM_ANGLE_X
ParamAngleY PARAM_ANGLE_Y
ParamAngleZ PARAM_ANGLE_Z
ParamBodyAngleX PARAM_BODY_ANGLE_X

Accelerometer

Control model parameters using the phone hardware accelerator


Microphone

Use microphone control model parameters


Face Tracking

Item attributes see as Common Item Attributes A

Param Default Value
Angle X ParamAngleX / PARAM_ANGLE_X
Angle Y ParamAngleY / PARAM_ANGLE_Y
Angle Z ParamAngleZ / PARAM_ANGLE_Z
Position X ParamBodyAngleZ / PARAM_BODY_ANGLE_Z
Position Y
Position Z
Left Eye Opening ParamEyeLOpen / PARAM_EYE_L_OPEN
Right Eye Opening ParamEyeROpen / PARAM_EYE_R_OPEN
Eye Wide
Eye Squint
Eyeball X ParamEyeBallX / PARAM_EYE_BALL_X
Eyeball Y ParamEyeBallY / PARAM_EYE_BALL_Y
Left Brow Y ParamBrowLY / PARAM_BROW_L_Y
Right Brow Y ParamBrowRY / PARAM_BROW_R_Y
Mouth Opening ParamMouthOpenY / PARAM_MOUTH_OPEN_Y
Mouth Form ParamMouthForm / PARAM_MOUTH_FORM
Mouth Pucker
Mouth Funnel
Cheek Puff
Tongue Out

Hand Tracking

Item attributes see as Common Item Attributes A

Param Description Note
Angle X Wrist flip ■ Five states, corresponding to values (-1, -0.5, 0, 0.5, 1)
■ -1= minimum parameter value; 1= Maximum parameter value
Angle Z Wrist shake
Position X Left and right relative position of wrist ■ Relative to the reference position
Position Y Upper and lower relative position of wrist ■ Relative to the reference position
Thumb ■ Bend = minimum; Straighten = maximum
Index ■ Bend = minimum; Straighten = maximum
Middle ■ Bend = minimum; Straighten = maximum
Ring ■ Bend = minimum; Straighten = maximum
Pinky ■ Bend = minimum; Straighten = maximum
Gap: Thumb-Index ■ Close = minimum; Open = maximum
Gap: Index-Middle ■ Close = minimum; Open = maximum
Gap: Middle-Ring ■ Close = minimum; Open = maximum
Gap: Ring-Pinky ■ Close = minimum; Open = maximum

Intimacy System

Item Description
Initial Value The initial value assigned when the model is first loaded. This value must be between the maximum and minimum values
Min Value Lower intimacy limit
Max Value Higher intimacy limit
Active Bonus The bonus value per minute when the model is loaded, usually set to a positive value
Inactive Bonus The bonus value for each minute the model is not loaded, usually set to a negative value
Bonus Daily Limit Maximum daily bonus
ID Binds to a model parameter whose value is controlled by intimacy and is often used to display the current intimacy value

Tips

Can change the intimacy value from the intimacy property of the motion event


Key Trigger

Item Description
Motion when pressed Triggered when the button is pressed
Motion when lifted Triggered when the key is lifted

Tips

To make the keys work, you need to enable hotkeys in Control Panel Settings.


Param Trigger

Item Description
Name Item name
Parameter ID parameter
Trigger Values ■ Value: The specified motion is triggered when the parameter value passes through this value作
■ Direction: Forward indicates that the parameter value is valid when it passes through the trigger value from small to large; Backward indicates that the process from large to small is effective
■ Two-Way indicates it is valid as long as it passes through

Area Trigger

Item Description
Name Item name
Target Area Activated region
Motion When Entered The motion triggered when trigger area enters the target area
Motion When Exited The motion triggered when trigger area exits the target area
Trigger Area Active trigger area

Tips

  • The system continuously detects whether the target area overlaps with the trigger area, and triggers the "motion when entered" and "motion when exited"】
  • Because each frame is detected, performance may be affected

Hand Trigger

Item Description
Name Item name
Hand Active hand
Direction ■ Ignore: Nondirection
■ Forward: Palms facing the camera
■ Backward: Opisthenar facing the camera
Motion Active motion
Fingers ■ Ignore: Not judge the finger
■ Bend: Fingers straight
■ Stretch: Fingers bend

#Appendix: Common Item Attributes A

Item Description Mouse Tracking Lip Sync Eye Blink Face Tracking Hand Tracking
Parameter Model parameter
Axis The XY axis of the mouse
Flip Flip parameter value
Min Parameter minimum
Max Parameter maximum
Default Parameter default
Factor Actual value = face capture x factor, limit range (-1, 1)
Blend Mode Blend mode of parameters and model motions
Weight The influence degree of parameter value on the model, namely actual influence value = parameter value x weight
Input Binds directly to mouse movement or left and right keys
Sort The layer of parameters may affect the stacking effect. The larger the layer number is, the later it is

Max, Min and Default

  • The parameter has its own maximum, minimum and default values, which are automatically filled in when the parameter is selected
  • Customize three values, overwriting the values of the parameters
  • The customized value must be within the range of the maximum and minimum parameters

#Appendix: Common Item Attributes B

Item Description
Name Item name
Text Displays the text, or displays the item name if not filled in
Value Initial value
Hidden from users Not show in edit panel
ID group Associated parameter ID group
Key Values ■ This parameter is used only for the controller
■ If there are key values, the user interface displays them in the form of left and right arrows; otherwise, it displays them in the form of sliders

Hidden from users

Under normal circumstances, users can modify the item value through the edit panel. If the item is a fixed value or do not want to modify it, please check "Hidden from users".

#Appendix: Available Commands

  • Commands separate each argument with a space. If there are spaces in the ID or path, please add a backslash before the spaces. For example, "my model" needs to be written as "my model"
  • Multiple commands are separated by semicolons (;)
Command Description Example
open_url Open the link from browser open_url https://www.baidu.com
change_cos Change clothes change_cos cos02.model.json
start_mtn Start the motions of the specified model start_mtn model_id group:motion (The model_id can be omitted and represents the current model)
stop_mtn Stops the motion of specifying layer stop_mtn 1 (1 indicates the layer number), 0 for default layer
set_exp Set expression set_exp 01.exp.json
next_exp Next expression
clear_exp Clear expression
replace_tex Replace texture replace_tex 1 tex/texture_01.png  (Texture numbers start from 0, 1 represents the second texture)
stop_sound Stop sound stop_sound 0 (0 is the channel identifier)
stop_all_sounds Stop all sounds
mute_sound Mute sound mute_sound 0 (0 is the channel identifier)
unmute_sound Unmute sound
hide_text Hide text
Item Command Description Example
parameters
parts
artmesh_opacities
artmesh_colors
lock
unlock
set
lock
unlock
set
■ parameters lock PARAM_ANGLE_X 10 (10 is the lock parameter value)
■ parameters lock PARAM_ANGLE_X $var (Set the float variable named var to the parameter value, starting with $)
■ parameters lock PARAM_ANGLE_X @PARAM_NAME (Assign the value of parameter PARAM_NAME to the target parameter, starting with @)
■ "parameters unlock PARAM_ANGLE_X
parameters unlock(Unlock all)
■ parameters set PARAM_ANGLE_X 10 (10 is the lock parameter value)
■ parameters set PARAM_ANGLE_X $var (Set the float variable named var to the parameter value, starting with $)

* The difference between a lock and a set is that a lock is persistent, whereas a set is assigned only once
motions enable
disable
enable
disable
■ motions enable group:motion
■ motions disable group:motion
hit_areas
param_loop
enable
disable
enable
disable
■ hit_areas enable area_name(area_name is area name)
■ hit_areas disable area_name
param_hit enable
disable
lock
unlock
begin
end
begin
end
lock parameter
unlock parameter
Begin drag
End drag
■ param_hit enable name
■ param_hit disable name
■ param_hit lock name
■ param_hit unlock name
■ param_hit begin name PARAM_NAME
■ param_hit end name
mouse_tracking
physics
extra_motion
auto_breath
enable
disable
enable
disable
■ mouse_tracking enable
■ mouse_tracking disable
eye_blink
lip_sync
enable
disable
enforce
enable
disable
enforce
■ lip_sync enable
■ lip_sync disable
■ lip_sync enforce

Expressions

Item Description
Name Expression name
File Expression file

Physics

Item Description
File Set the physic3.json file
Max Weight The greater the value, the greater the influence of physics on the model

Pose

Set the pose. json file


Options

Item Description
ID Model ID, used for model-to-model interactions
Name Display name, which will be used to display model names in various places (such as text box)
Scale Factor The default scale for the model
Position X The default left and right positions of the model
Position Y The default up and down position of the model
Anisotropic Filtering Level Anisotropic filtering makes mapping look better in some cases, but adds to the performance overhead of graphics hardware. A value greater than 1 overrides the map anisotropic filtering level set in the application
Edge Padding Fixed black edges on models
Allow User Modification After this parameter is selected, can customize the model
Mask Buffer Size In some cases, models with masks have serrated edges. Increasing the buffer size reduces jagged edges, but affects performance

Revision Date: Feb 24, 2024