Effekseerの未使用テクスチャを検出・整理するプラグイン

/*:
@target MZ
@plugindesc Effekseerの未使用テクスチャを検出・整理します
@author munokura
@url raw.githubusercontent.com/munokura/MNKR-MZ-plugins/master/MNKR_OptimizeEffekseerTexture.js

@help
# 概要
RPGツクールMZのデプロイメントの選択肢「未使用ファイルを除外する」では、
Effekseer内のテクスチャは除外対象になりません。

このプラグインを使用・実行することで、
Effekseerアニメーションで実際に使用されているテクスチャを検出し、
未使用のテクスチャファイルを整理できます。

# 使い方
## 基本的な使い方
プラグインコマンド「テクスチャを整理」を実行するだけで、
退避→検出→復元→レポート出力が自動的に行われます。

## 手動での使い方（デバッグ用）
1. プラグインコマンド「テクスチャを退避」を実行。
2. プラグインコマンド「必要なテクスチャを検出」を実行。
3. プラグインコマンド「必要なテクスチャを復元」を実行。
4. 必要に応じて「未使用テクスチャを削除」でバックアップを削除。

# 注意
- Node.js環境(テストプレー時)でのみ動作します。
- 必ずバックアップを取ってから実行してください。
- effects/Texture/フォルダ内のファイルが移動・削除されます。
サブフォルダ内のファイルも対象となります。
- それ以外のフォルダは調査対象外です。
- 公開するゲームではプラグインを無効にしてください。
- 広告ブロック等のブラウザ拡張機能が有効だと、
処理がクラッシュ、または失敗する場合があります。
その場合は、テストプレイ時に拡張機能を無効にしてください。

# 利用規約
MITライセンスです。
opensource.org/licenses/mit-license.php
作者に無断で改変、再配布が可能で、
利用形態（商用、18禁利用等）についても制限はありません。

@param backupFolderName
@text バックアップフォルダ名
@desc テクスチャを退避するフォルダ名
@default Texture_Backup
@type string

@param outputFilePath
@text 結果ファイル出力先
@desc 結果を出力するCSVファイルパス（プロジェクトフォルダからの相対パス）
@default EffekseerTextureReport.csv
@type string

@param errorLogFilePath
@text 処理ログ出力先
@desc 処理ログを出力するファイルパス（プロジェクトフォルダからの相対パス）
@default EffekseerTextureProcess.txt
@type string

@param csvHeader1
@text CSVヘッダー1列目
@desc CSVの1列目のヘッダー名
@default 使用efkefc
@type string

@param csvHeader2
@text CSVヘッダー2列目
@desc CSVの2列目のヘッダー名
@default efkefcテクスチャ
@type string

@param waitFrames
@text 待機フレーム数
@desc 各エフェクト読み込み後の待機フレーム数（エフェクト数が多い場合は増やしてください）
@default 60
@type number
@min 10
@max 300

@param renameToMatchCase
@text ファイル名の大文字小文字を統一
@desc 復元時に要求されたファイル名に合わせて、テクスチャファイル名をリネームします
@default false
@type boolean

@param startMessage
@text 開始メッセージ
@desc 処理開始時に表示するメッセージ
@default テクスチャ整理を開始します\n\n※この処理中はテストプレイ画面をアクティブに保ってください\n\n続行しますか?
@type string

@param completeMessage
@text 完了メッセージ
@desc 処理完了時に表示するメッセージ（{count}は復元数に置き換えられます）
@default 処理が完了しました\n復元したテクスチャ: {count}個
@type string

@command organizeTextures
@text テクスチャを整理
@desc テクスチャの退避・検出・復元を自動的に行います

@arg doBackup
@text テクスチャを退避
@desc テクスチャを退避するかどうか
@type boolean
@default true

@arg doDetect
@text 必要なテクスチャを検出
@desc 必要なテクスチャを検出するかどうか
@type boolean
@default true

@arg doRestore
@text 必要なテクスチャを復元
@desc 必要なテクスチャを復元するかどうか
@type boolean
@default true

@command backupTextures
@text テクスチャを退避（手動）
@desc effects/Texture/を一時的にバックアップフォルダに移動します

@command detectRequiredTextures
@text 必要なテクスチャを検出（手動）
@desc 全エフェクトを読み込み、必要なテクスチャを記録します

@command restoreTextures
@text 必要なテクスチャを復元（手動）
@desc 検出された必要なテクスチャのみをバックアップから復元します

@command deleteUnusedTextures
@text 未使用テクスチャを削除
@desc バックアップフォルダ内の未使用テクスチャを削除します（復元不可）
*/