Persona

表情パネル上部の新規表情をクリックすると、モデルと同じフォルダーに新しい.exp3.json表情ファイルを作成できます。各表情ボタンの右側にあるドロップダウンメニューから編集…や複製…が行えるほか、モデル設定ファイルで保護されていない単体ファイルの場合は、さらに名前の変更…や削除…も利用できます。

表情エディターはLive2Dモデル専用の機能です。保存した表情ファイルはモデルを再読み込みすることなく、即座に表情リストへ反映されます。

エディターアンカーリンクをコピー

ダイアログの左側では表情ファイル全体のプロパティを設定し、右側には現在のモデルがサポートするすべてのパラメータがコントロール行として一覧表示されます。

各パラメータ行の左端にあるスイッチで、そのパラメータを表情ファイルに含めるかどうかを切り替えます。オンにするとブレンドモードのドロップダウンと数値調整スライダーが表示されます。行にはパラメータの所属グループとIDが明示され、物理演算が動かすパラメータには物理演算バッジが表示されます。

保存をクリックすると変更内容がファイルへ書き込まれます。キャンセルをクリックすると編集を破棄して終了します（未保存の変更がある場合、誤操作防止のためキャンセルボタンが強調色に変化します）。

ショートカットアンカーリンクをコピー

ショートカット設定欄では、表情を切り替えるキーをその場で直接バインドできるため、表情作成からキー割り当てまでを一度の操作で完了できます。ショートカットを追加をクリックすると新しいバインディングが作成され、見出し右側の入力欄で組み合わせキーを記録します（アバターショートカットのショートカットを設定…と同じレコーダー仕様です）。

これらの項目は該当ショートカットの再生方法に対応しており、オートメーション一覧にあるメニューの設定内容と共通です。フェード時間をデフォルト以外の特定数値に指定した場合、そのショートカット経由で切り替える際はファイル自身のフェードイン・フェードアウト設定よりも優先されます。なお、UIボタンのクリック、プラグインAPI、オートメーションによる実行時は、引き続きファイル自身の設定時間が適用されます。

この画面では、その表情ファイルに割り当てられた最初のショートカットのみを表示・編集します。複数のショートカットが設定されている場合は総件数が表示され、オートメーションへのリンクが案内されます（バックグラウンドで動作、ショートカットの削除、追加キーの管理などはそちらで行えます）。新規作成や複製直後のファイルにはショートカットは設定されていません。

ショートカット設定は保存時に表情ファイル本体と同時に書き込まれます（保存後のファイル名を基準としてバインドされます）。編集セッション中に実際に変更された項目のみが書き込まれるため、ダイアログを開いている間にオートメーションやプラグインAPI経由で変更された設定が上書きされることはありません。また、その間に外部から削除されたショートカットが意図せず再作成されることもなく、その場合はショートカットが保存されなかった旨が表示され、表情ファイル本体のみが正常に保存されます。

ブレンドモードアンカーリンクをコピー

スライダーに表示される値は、常にモデル上で最終的に落ち着く合成値です。「追加」モードの場合でもUI上では絶対値として直感的に操作でき、ファイル保存時にデフォルト値との差分（デルタ値）へ自動換算されます。

ブレンドモードを切り替えても各モードごとの値は保持されるため、モードを行き来しても調整データが失われることはありません。

プレビューアンカーリンクをコピー

エディターを開いている間、右側の一覧で行ったパラメータ調整はステージ上のモデルへリアルタイムに反映されます。プレビューパイプラインはすべての入力やトラッキング処理の後に実行されるため、フェイストラッキングによってパラメータが動いている最中でも、調整内容をはっきりと確認できます（VTube Studioの表情エディターと同様の仕様です）。

現在編集中の表情自身は一時的に自動ミュートされます。有効状態やフェード時間は維持されたままパラメータへの出力のみが停止するため、プレビューの調整値が編集前の旧データと重複して二重にかかるのを防ぎます。ソロスイッチをオンにすると、ステージ上で有効になっている他のすべての表情も同時に一時ミュートされます。ソロをオフにすると、他の有効な表情の上に編集内容が重なり、保存後の最終的な合成結果を確認できます。

一時ミュートは表情の完全なオフとは異なります。エディターを開いている間も、ショートカット、オートメーション、プラグインAPIによる表情の切り替えや保存は通常通りバックグラウンドで動作し、エディターを閉じた際に追加の復元処理を行う必要はありません。

物理演算が駆動するパラメータはリアルタイムプレビューの対象外となり、実行時に物理演算シミュレーションによって動的に算出されます。物理演算を表示は、それらのパラメータの値を設定してファイルへ保存できるようにするための機能です。

ポーズをキャプチャアンカーリンクをコピー

ポーズをキャプチャをクリックすると、トラッキング、モーション、待機アニメーションを合算した現フレームのモデルの全パラメータ状態を一括取得し、デフォルト値から変化しているパラメータをすべて「追加」モードの行として自動的に有効化します。

全パラメータがデフォルト値のまま変化していない場合は、キャプチャするものがありませんと表示され、行は追加されません。

保存先アンカーリンクをコピー

新規作成または複製した表情ファイルは、モデルのルートフォルダー（VTube Studioが標準で使用する表情フォルダー）に保存されます。同名の表情がすでに特定のフォルダーに存在する場合は、そのファイルの隣に保存されます。既存ファイルを編集した場合は、常に元のファイルパスへ直接上書き保存されます。

保存されたファイルは即座に反映されます。新しいファイルは表情パネル内に新しい項目として追加され、既存のファイルはその場で更新されます。変更された表情が現在アクティブになっている場合は、フェードを挟むことなく即座に新しい調整値へ切り替わります。

既存の表情ファイルと同名のファイル名を作成することはできません（ショートカットや表情を記憶するがファイル名に直接紐づいているためです）。物理ファイルとして同名のファイルがすでにディスク上に存在する場合は、既存のファイルを置き換えますか？と確認ダイアログが表示されます。

名前の変更と削除アンカーリンクをコピー

名前の変更や削除ができるのは、.model3.jsonで宣言されていない単体の表情ファイルのみです。モデル設定ファイルに宣言されているビルトイン表情は保護されており、変更や削除はできません（Personaがモデルの基本設定ファイルを改変することはありません）。ビルトイン表情に対しても編集…や複製…は可能で、複製によって作成された新しいファイルは通常の単体ファイルとして扱われます。

名前の変更…：ディスク上の表情ファイル名を変更し、紐づいているアバターショートカットや表情を記憶するの登録情報も自動的に追従更新します。アクティブ中の表情は新しい名前のまま有効状態を維持します。

削除…：表情ファイルをシステムのゴミ箱へ移動し、紐づいていたショートカットの登録も解除します（確認ダイアログに影響を受けるショートカットの件数が明示されます）。

名前の変更および削除はトランザクション安全性を確保して実行されます。ショートカットや記憶データの更新を先に行い、最後にディスク上のファイルを操作します。サイドカーファイルへの書き込みに失敗した場合（読み取り専用やフォーマット破損など）、操作全体が中断され、元のファイルはそのまま維持されます。

ファイルの互換性アンカーリンクをコピー

Personaは高度なファイル互換性を備えています。フェード時間、オフになっているパラメータ、さらにPersonaがネイティブ認識しないサードパーティ拡張フィールド（VTube StudioのIsModelCustomizationExpressionなど）も含め、元のファイルに含まれていた全データがそのまま保持され、上書き保存時にも欠落しません（VTube Studio自身が書き込み時に未知のフィールドを破棄してしまう問題を防ぎます）。

同一パラメータに対して同じブレンドモードの指定が複数行に分かれている場合、エディター上では1行に自動統合されます。追加モードは合算、乗算モードは乗算、上書きモードは末尾の最新値を採用し、実行時の合成アルゴリズムと完全に一致させます。したがって、各行はそのパラメータに対する総合的な効果を表し、行をオフにすることで影響を完全に解除できます。

現在のモデルに存在しないパラメータがファイルに含まれている場合（複数モデル間で共用している表情ファイルなど）、Personaはそれらのデータを欠落させることなくそのままファイルへ書き戻し、リスト下部に表示できなかったエントリ件数を表示します。1つのパラメータに対して複数のブレンドモードが混在している場合、他のモードのデータは内部構造に保持され、該当行がオンになっている間のみ再生およびファイル書き込みが行われます。