コンテンツにスキップ

Live2D パラメータリファレンス

Parameters タブは、Live2D モデルの見た目と動きを調整するコントロールセンターです。すべてのスライダーが Cubism パラメータに直接マッピングされており、ドラッグするとリアルタイムで変化を確認できます。

パラメータの概要

Live2D モデルは、モデルの CDI3.json カテゴリに基づいてグループ分けされた多数のパラメータを公開しています。一般的なグループ：

顔 — 頭の角度、視線追跡、眉毛
目 — 開閉、瞳孔の方向
口 — 開閉、形状、リップシンク
体 — 胴体の角度、呼吸
腕/手 — 四肢の位置
髪/アクセサリー — 物理演算または手動制御

検索とフィルター

上部の検索バーでパラメータ名で検索できます。ローカライズされた名前と生のパラメータ ID の両方に対応しています。

オリジナル ID を表示 を切り替えると、読みやすい名前と生の Cubism パラメータ ID（例：ParamAngleX）を切り替えられます。

主要パラメータ

パラメータ	説明	典型的な範囲
`ParamAngleX`	頭部の水平回転（左右）	-30 ~ 30
`ParamAngleY`	頭部の垂直回転（上下）	-30 ~ 30
`ParamAngleZ`	頭部の傾き	-30 ~ 30
`ParamEyeLOpen`	左目の開閉	0 ~ 1
`ParamEyeROpen`	右目の開閉	0 ~ 1
`ParamEyeBallX`	瞳孔の水平方向	-1 ~ 1
`ParamEyeBallY`	瞳孔の垂直方向	-1 ~ 1
`ParamBrowLY`	左眉の高さ	-1 ~ 1
`ParamBrowRY`	右眉の高さ	-1 ~ 1
`ParamMouthOpenY`	口の開閉（TTS リップシンクに使用）	0 ~ 1
`ParamMouthForm`	口の形状（-1 = すぼめ、1 = 微笑み）	-1 ~ 1
`ParamBodyAngleX`	体の水平揺れ	-10 ~ 10
`ParamBreath`	呼吸アニメーションサイクル	0 ~ 1

モーション

モーションはモデルにバンドルされた事前構築のアニメーション（.motion3.json ファイル）です。時間の経過に伴うパラメータ変化のシーケンスを再生します。

モーションの再生

Parameters タブの Motions セクション：

任意のモーションの Play をクリックしてプレビュー
Stop をクリックして再生を停止

デフォルトアイドルモーション

エージェントがアクションを実行していない時に継続的に再生されるデフォルトのアイドルモーションを設定：

リストで好みのアイドルモーションを見つける
横にある ピンアイコン（「デフォルトアイドルに設定」）をクリック
エージェントがアイドル状態のときにこのモーションがループ再生されます

アイドルモーションをクリアするには、リセット をクリック。

パーツ（不透明度）

パーツはモデル内のドローアブルのグループ — 「左腕」「メガネ」「尻尾」「衣装 A vs B」のようなレイヤーです。

表示の切り替え

Parts セクション：

パーツの オン/オフ を切り替えて表示/非表示
非表示のパーツは完全に見えなくなります（不透明度 = 0）

一般的なユースケース：

衣装切り替え — 「カジュアル」パーツを非表示にして「フォーマル」パーツを表示
アクセサリーの切り替え — メガネ、帽子、持ち物の表示/非表示
重複要素 — 一方の腕ポーズを非表示にして別のポーズを表示

表情

表情はモデルにバンドルされたパラメータプリセット（.exp3.json ファイル）です。「微笑み」「驚き」「怒り」のようなパラメータ変更セットを一度に適用します。

Expressions セクション：

表情名をクリックしてモデルに適用
もう一度クリックして解除
複数の表情を同時にアクティブにできます（パラメータがブレンドされます）

表情 vs Expression マッピング

機能	モデル表情（ここ）	Expression マッピング（エージェント設定）
ソース	`.exp3.json` にバンドル	条件を定義（emotion + action）
トリガー	手動クリック	エージェント状態に基づいて自動
範囲	パラメータプリセットのみ	立ち絵、背景、テキストも含む

モデル表情は見た目のプレビューに最適です。エージェント駆動の自動アニメーションにはアニメーションとマッピングを使用してください。

次のステップ

アニメーションとマッピング — アニメーションクリップを作成し、エージェント状態にマッピング
はじめに — モデルインポートの基本に戻る