【Live2D】公式のPhotoshop書き出しスクリプトを便利にする方法

2019年2月26日2026年10月29日

2019年のLive2D_Preprocessを、複製したPSDで処理して別名保存するよう変更した記録です。2026年10月24日にコードを再点検し、保存名と保存処理の配置を修正しました。Photoshop上での実機検証は未実施です。

公式のPhotoshop書き出しスクリプトを便利にする方法

公式マニュアルにはLive2D_Preprocess v1.4（2019年4月8日）の更新履歴があります。下記の旧画像の行番号は当時のものです。コードの位置は行番号ではなく、初期化・最上位の処理呼び出し・関数定義で判断してください。

オリジナルのデータはそのままで、PSDデータを複製してから統合し、「_書き出し」という名前を加えて保存します。

公式スクリプトの入手先と処理内容は下記のマニュアルで確認できます。改変時は配布物の著作権表示・ライセンス表示を保持してください。実行前に編集用PSDを保存し、さらに別ファイルとしてバックアップします。

公式Preprocessはグループ、レイヤーマスク、クリッピングマスクを結合し、パス情報を削除します。

出力PSDでは結合前の部品やマスクを個別に編集できなくなるため、編集用の元PSDを残してください。

結合したくないグループには、グループ名の先頭に半角の*を付けます。

例えば*顔です。

この指定はグループの結合を避けるもので、スクリプト全体の処理を無効にする指定ではありません。

2026年10月29日に公式マニュアルの処理内容を再確認しました。

以下の保存処理の改変を含め、Photoshopでの実行結果は未検証です。

https://docs.live2d.com/cubism-editor-manual/script-download/ 旧改変コードのGistは履歴資料です。再帰関数LayerCheck内に保存・クローズ処理が置かれており、子階層の処理途中で閉じる可能性があります。そのまま実行せず、以下のように保存は最上位の処理終了後に一度だけ行います。Gist自体は今回変更していません。

目標は元ファイルがmodel.psdなら、同じフォルダにmodel_書き出し.psdを保存することです。保存は完了アラートより前に行います。同名ファイルがあれば停止する例にし、既存の書き出し結果を自動上書きしないようにしています。

Live2D公式Photoshopスクリプトのカスタマイズ手順

現在の入手先は上記の公式マニュアルからたどってください。Live2D_Preprocess旧配布先は当時のリンクです。
配布ファイルをコピーし、別名の.jsxをテキストエディタで編集します。以下は差し込み部分で、公式の結合処理全体を含む完成スクリプトではありません。

処理開始前に保存先を確認してPSDを複製する

if (app.documents.length === 0) {
    throw new Error("PSDを開いてから実行してください。");
}
var originalDoc = app.activeDocument;
// 未保存の編集内容も含め、先に保存・バックアップする
if (!originalDoc.saved) {
    throw new Error("元のPSDを保存してから実行してください。");
}
var filePath = originalDoc.path;
var fileName = originalDoc.name.replace(/\.[^.]+$/, "");
var outputFile = new File(filePath.fsName + "/" + fileName + "_書き出し.psd");
if (outputFile.exists) {
    throw new Error("同名の書き出しファイルがあります。保存先を確認してください。");
}
var copiedDoc = originalDoc.duplicate();
app.activeDocument = copiedDoc;
var doc = copiedDoc;
// 以降の結合対象はcopiedDocにする。元の初期化処理との重複に注意。

最上位の結合処理が終了してから一度だけ保存する

// 公式の最上位の結合処理が完了した直後に置く。
// LayerCheckなど、再帰する関数の中には置かない。
saveSceneAs();
alert("書き出し完了！");

複製したドキュメントを別名保存する関数を定義する

function saveSceneAs() {
    if (outputFile.exists) {
        throw new Error("同名ファイルが作成されたため保存を中止しました。");
    }
    var psdOptions = new PhotoshopSaveOptions();
    psdOptions.alphaChannels = true;
    psdOptions.annotations = true;
    psdOptions.embedColorProfile = true;
    psdOptions.layers = true;
    psdOptions.spotColors = false;
    copiedDoc.saveAs(outputFile, psdOptions, true, Extension.LOWERCASE);
    // 保存に失敗した場合はここへ進まず、複製を開いたままにする。
    copiedDoc.close(SaveOptions.DONOTSAVECHANGES);
    app.activeDocument = originalDoc;
}