mocopi parameter list
nizima LIVE can move the whole body of a Live2D model by acquiring information from mocopi.
This page summarizes the specifications of mocopi parameters in nizima LIVE; please refer to the contents of this page when creating mocopi-compatible models.
Auto-tethered ID: This is a recommended parameter ID when creating a mocopi-compatible model. If you create each parameter of a Live2D model with this parameter ID, it will be automatically tied to the corresponding tracking item when the Live2D model is loaded into nizima LIVE.
Display name: Display name of each parameter on nizima LIVE.
Minimum, default and maximum values: recommended parameter ranges for models used in nizima LIVE.
face
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| Yaw | ParamAngleX | Movement of the face from side to side | -30 | 0 | 30 | existing |
| Pitch | ParamAngleY | Up and down movement of the face | -30 | 0 | 30 | existing |
| Roll | ParamAngleZ | Rotational movement of the face | -30 | 0 | 30 | existing |
| RollRelative | ParamAngleZRelative | Face rotation movement (relative) | -30 | 0 | 30 | Head rotation – Torso rotation |
| PositionX | Face position X | -1 | 0 | 1 | existing | |
| PositionY | Face position Y | -1 | 0 | 1 | existing | |
| PositionZ | Face position Z | -1 | 0 | 1 | existing |
- Position
- Difference from mocopi’s reference position in absolute coordinates
body
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| HipAngleZ | HipAngleZ | sideways swing of the hips | -30 | 0 | 30 | Similar to Roll |
| TorsoAngleX | TorsoAngleX | Upper body rotation X | -30 | 0 | 30 | Similar to Yaw |
| TorsoAngleY | TorsoAngleY | Upper body rotation Y | -30 | 0 | 30 | Similar to Pitch |
| TorsoAngleZ | TorsoAngleZ | Upper body rotation Z | -30 | 0 | 30 | Similar to Roll |
| BodyPositionX | BodyPositionX | Whole body position X | -1 | 0 | 1 | Right hand direction is +. |
| BodyPositionY | BodyPositionY | Whole body position Y | -1 | 0 | 1 | Top is + |
| BodyPositionZ | BodyPositionZ | Whole body position Z | -1 | 0 | 1 | Front is + |
HipAngle Image Description
|
|
Basic state | Rotation X |
|
|
Rotate Y | Rotation Z |
TorsoAngle Image Description
|
|
Basic state | Rotation X |
|
|
Rotation Y | Rotation Z |
- BodyPositionX/Z
- Position of the hips
- Difference from mocopi’s reference position in absolute coordinates
- BodyPositionY
- The lower of the left and right hip joints
- Difference from mocopi’s reference position in absolute coordinates
left arm
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| UpperArmLeftAngleY | UpperArmLeftAngleY | Left upper arm angle Y | -90 | 0 | 90 | Front is + |
| UpperArmLeftAngleZ | UpperArmLeftAngleZ | Left upper arm angle Z | -180 | 0 | 180 | 0 on the bottom, + on the outside |
| UpperArmLeftAngleZRelative | UpperArmLeftAngleZRelative | Left upper arm angle Z | -180 | 0 | 180 | Left upper arm angle – upper body rotation |
| LowerArmLeftAngleX | LowerArmLeftAngleX | Left forearm angle X | -180 | 0 | 180 | 0 in front of the palm, + in front of the little finger side |
| LowerArmLeftAngleY | LowerArmLeftAngleY | Left forearm angle Y | -90 | 0 | 90 | Front is + |
| LowerArmLeftAngleZ | LowerArmLeftAngleZ | Left forearm angle Z | -180 | 0 | 180 | 0 on the bottom, + on the outside |
| LowerArmLeftAngleZRelative | LowerArmLeftAngleZRelative | Left forearm angle Z (relative) | -180 | 0 | 180 | Left front wrist angle – Left upper wrist angle |
| ElbowLeftAngle | ElbowLeftAngle | Left elbow angle | 0 | 0 | 180 | 0 when extended, + when bent |
| ElbowLeftPositionX | ElbowLeftPositionX | Left elbow position X | -1 | 0 | 1 | Outside is + |
| ElbowLeftPositionY | ElbowLeftPositionY | Left elbow position Y | -1 | 0 | 1 | Top is + |
| ElbowLeftPositionZ | ElbowLeftPositionZ | Left elbow position Z | -1 | 0 | 1 | Front is + |
- ElbowLeftPosition
- Position of the elbow in relation to the shoulder
right arm
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| UpperArmRightAngleY | UpperArmRightAngleY | Right upper arm angle Y | -90 | 0 | 90 | Front is + |
| UpperArmRightAngleZ | UpperArmRightAngleZ | Right upper wrist angle Z | -180 | 0 | 180 | 0 on the bottom, + on the outside |
| UpperArmRightAngleZRelative | UpperArmRightAngleZRelative | Right upper arm angle Z (relative) | -180 | 0 | 180 | Right upper arm angle – upper body rotation |
| LowerArmRightAngleX | LowerArmRightAngleX | Right forearm angle X | -180 | 0 | 180 | 0 in front of the palm, + in front of the little finger side |
| LowerArmRightAngleY | LowerArmRightAngleY | Right forearm angle Y | -90 | 0 | 90 | Front is + |
| LowerArmRightAngleZ | LowerArmRightAngleZ | Right forearm angle Z | -180 | 0 | 180 | 0 on the bottom, + on the outside |
| LowerArmRightAngleZRelative | LowerArmRightAngleZRelative | Right forearm angle Z (relative) | -180 | 0 | 180 | Right front wrist angle – Right upper wrist angle |
| ElbowRightAngle | ElbowRightAngle | Right elbow angle | 0 | 0 | 180 | 0 when extended, + when bent |
| ElbowRightPositionX | ElbowRightPositionX | Right elbow position X | -1 | 0 | 1 | Outside is + |
| ElbowRightPositionY | ElbowRightPositionY | Right elbow position Y | -1 | 0 | 1 | Top is + |
| ElbowRightPositionZ | ElbowRightPositionZ | Right elbow position Z | -1 | 0 | 1 | Front is + |
left hand
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| HandLeftFound | HandLeftFound | Left hand detection | 0 | 0 | 1 | Existing, hands up +. |
| HandLeftAngleX | HandLeftAngleX | Left hand angle X | -180 | 0 | 180 | Existing, palm 0 in front, pinky side + in front |
| HandLeftAngleY | HandLeftAngleY | Left hand angle Y | -90 | 0 | 90 | Existing, front +. |
| HandLeftAngleZ | HandLeftAngleZ | Left hand angle Z | -180 | 0 | 180 | Existing, 0 below, + outside |
| HandLeftPositionX | HandLeftPositionX | Left hand position X | -1 | 0 | 1 | Existing, outside is +. |
| HandLeftPositionY | HandLeftPositionY | Left hand position Y | -1 | 0 | 1 | Existing, top is +. |
| HandLeftPositionZ | HandLeftPositionZ | Left hand position Z | -1 | 0 | 1 | Existing, front +. |
right hand
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| HandRightFound | HandRightFound | Right hand detection | 0 | 0 | 1 | Existing, hands up +. |
| HandRightAngleX | HandRightAngleX | Right hand angle X | -180 | 0 | 180 | Existing, palm 0 in front, pinky side + in front |
| HandRightAngleY | HandRightAngleY | Right hand angle Y | -90 | 0 | 90 | Existing, front +. |
| HandRightAngleZ | HandRightAngleZ | Right hand angle Z | -180 | 0 | 180 | Existing, 0 below, + outside |
| HandRightPositionX | HandRightPositionX | Right hand position X | -1 | 0 | 1 | Existing, outside is +. |
| HandRightPositionY | HandRightPositionY | Right hand position Y | -1 | 0 | 1 | Existing, top is +. |
| HandRightPositionZ | HandRightPositionZ | Right hand position Z | -1 | 0 | 1 | Existing, front +. |
left leg
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| UpperLegLeftAngleY | UpperLegLeftAngleY | Left thigh angle Y | -30 | 0 | 30 | Front is + |
| UpperLegLeftAngleZ | UpperLegLeftAngleZ | Left thigh angle Z | -30 | 0 | 30 | 0 on the bottom, + on the outside |
| LowerLegLeftAngleX | LowerLegLeftAngleX | Left shin angle X | -30 | 0 | 30 | Toe 0 in front, + outside |
| LowerLegLeftAngleY | LowerLegLeftAngleY | Left shin angle Y | -30 | 0 | 30 | Front is + |
| LowerLegLeftAngleZ | LowerLegLeftAngleZ | Left shin angle Z | -30 | 0 | 30 | 0 on the bottom, + on the outside |
| LowerLegLeftAngleZRelative | LowerLegLeftAngleZRelative | Left shin angle Z (relative) | -30 | 0 | 30 | Left shin angle – Left thigh angle |
| KneeLeftAngle | KneeLeftAngle | Left Knee Angle | 0 | 0 | 180 | 0 when extended, + when bent |
| KneeLeftPositionX | KneeLeftPositionX | Left knee position X | -1 | 0 | 1 | Outside is + |
| KneeLeftPositionY | KneeLeftPositionY | Left knee position Y | -1 | 0 | 1 | Top is + |
| KneeLeftPositionZ | KneeLeftPositionZ | Left knee position Z | -1 | 0 | 1 | Front is + |
- KneeLeftPosition
- Position of the knee in relation to the hip joint
right leg
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| UpperLegRIghtAngleY | UpperLegRIghtAngleY | Right thigh angle Y | -30 | 0 | 30 | Front is + |
| UpperLegRightAngleZ | UpperLegRightAngleZ | Right thigh angle Z | -30 | 0 | 30 | 0 on the bottom, + on the outside |
| LowerLegRIghtAngleX | LowerLegRIghtAngleX | Right shin angle X | -30 | 0 | 30 | Toe 0 in front, + outside |
| LowerLegRIghtAngleY | LowerLegRIghtAngleY | Right shin angle Y | -30 | 0 | 30 | Front is + |
| LowerLegRightAngleZ | LowerLegRightAngleZ | Right shin angle Z | -30 | 0 | 30 | 0 on the bottom, + on the outside |
| LowerLegRightAngleZRelative | LowerLegRightAngleZRelative | Right shin angle Z (relative) | -30 | 0 | 30 | Right shin angle – Right thigh angle |
| KneeRightAngle | KneeRightAngle | Right Knee Angle | 0 | 0 | 180 | 0 when extended, + when bent |
| KneeRightPositionX | KneeRightPositionX | Right knee position X | -1 | 0 | 1 | Outside is + |
| KneeRightPositionY | KneeRightPositionY | Right knee position Y | -1 | 0 | 1 | Top is + |
| KneeRightPositionZ | KneeRightPositionZ | Right knee position Z | -1 | 0 | 1 | Front is + |
left foot
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| FootLeftPositionX | FootLeftPositionX | Left foot position X | -1 | 0 | 1 | Outside is + |
| FootLeftPosisionY | FootLeftPosisionY | Left foot position Y | -1 | 0 | 1 | Top is + |
| FootLeftPositionZ | FootLeftPositionZ | Left foot position Z | -1 | 0 | 1 | Front is + |
- Position of the ankle in relation to the hip joint
right foot
| ID | Auto-linked ID | expressed name | least | standard | largest | Remarks |
|---|---|---|---|---|---|---|
| FootRightPositionX | FootRightPositionX | Right foot position X | -1 | 0 | 1 | Outside is + |
| FootRightPositionY | FootRightPositionY | Right foot position Y | -1 | 0 | 1 | Top is + |
| FootRightPositionZ | FootRightPositionZ | Right foot position Z | -1 | 0 | 1 | Front is + |
Was this article helpful?
YesNo