Live2D Parameters Reference

The Parameters tab is your control center for adjusting how the Live2D model looks and moves. Every slider maps directly to a Cubism parameter — drag it and see the change in real-time.

Parameters Overview

Live2D models expose dozens of parameters organized into groups (based on the model’s CDI3.json categories). Common groups include:

• Face — Head angles, eye tracking, eyebrows
• Eyes — Open/close, pupil direction
• Mouth — Open/close, shape, lip-sync
• Body — Torso angle, breathing
• Arms/Hands — Limb positioning
• Hair/Accessories — Physics-driven or manual control

Search & Filter

Use the search bar at the top to find parameters by name. The search supports both localized names and raw parameter IDs.

Toggle Show original IDs to switch between human-readable names and the raw Cubism parameter IDs (e.g., ParamAngleX).

Common Parameters

Parameter	Description	Typical Range
ParamAngleX	Head horizontal rotation (left/right)	-30 ~ 30
ParamAngleY	Head vertical rotation (up/down)	-30 ~ 30
ParamAngleZ	Head tilt (lean left/right)	-30 ~ 30
ParamEyeLOpen	Left eye open/close	0 ~ 1
ParamEyeROpen	Right eye open/close	0 ~ 1
ParamEyeBallX	Pupil horizontal direction	-1 ~ 1
ParamEyeBallY	Pupil vertical direction	-1 ~ 1
ParamBrowLY	Left eyebrow height	-1 ~ 1
ParamBrowRY	Right eyebrow height	-1 ~ 1
ParamMouthOpenY	Mouth open/close (used for TTS lip-sync)	0 ~ 1
ParamMouthForm	Mouth shape (-1 = pout, 1 = smile)	-1 ~ 1
ParamBodyAngleX	Body horizontal sway	-10 ~ 10
ParamBreath	Breathing animation cycle	0 ~ 1

Tip

Not all models use all parameters. The parameter list shows only what your specific model supports.

Motions

Motions are pre-built animations bundled with your model (.motion3.json files). They play a sequence of parameter changes over time.

Playing Motions

In the Motions section of the Parameters tab:

• Click Play next to any motion to preview it
• Click Stop to halt playback

Default Idle Motion

Set a default idle motion that plays continuously when the agent is not performing any action:

1. Find your preferred idle motion in the list
2. Click the pin icon (“Set as default idle”) next to it
3. The motion will now loop whenever the agent is idle

To clear the idle motion, click Reset to default.

Note

The idle motion plays as a base layer. Animation clips from mapping rules play on top of it and take priority.

Parts (Opacity)

Parts are groups of drawables in your model — think of them as layers like “left arm”, “glasses”, “tail”, or “outfit A vs B”.

Toggle Visibility

In the Parts section:

• Toggle parts on/off to show or hide them
• Hidden parts are completely invisible (opacity = 0)

Common use cases:

• Outfit switching — Hide “casual clothes” parts, show “formal outfit” parts
• Accessory toggle — Show/hide glasses, hats, or held items
• Overlapping elements — Hide one arm pose to show another

Tip

Part visibility can also be animated in keyframe clips — see Animation & Mapping for details.

Expressions

Expressions are parameter presets bundled with your model (.exp3.json files). They apply a set of parameter changes at once — like “smile”, “surprised”, or “angry”.

In the Expressions section:

• Click an expression name to apply it to the model
• Click again to deactivate it
• Multiple expressions can be active simultaneously (their parameters blend)

Expressions vs. Expression Mapping

Feature	Model Expressions (here)	Expression Mapping (Agent Settings)
Source	Bundled in .exp3.json files	You define conditions (emotion + action)
Trigger	Manual click	Automatic based on agent state
Scope	Parameter preset only	Can include standing pictures, backgrounds, text

Model expressions are great for previewing looks. For automatic agent-driven animation, use the Animation & Mapping system.

Next Steps

• Animation & Mapping — Create animation clips and map agent states to animations
• Getting Started — Go back to model import basics