DuplicaterTools(DuplicateCleaner＆DuplicateMerger)

「DuplicateTools」は、Unityプロジェクト内に散らばった不要な"重複アセット"を検索し、安全に統合・削除するためのエディタ拡張ツールセットです！

同じデータのテクスチャが複数枚ある際などにPrefabなど使用されているデータを書き換え一つにまとめられます！

「プロジェクトの容量が膨らんでしまった」「同じマテリアルやテクスチャ、Prefabが複数存在していて管理が面倒」といった悩みを解決します。

重複アセットの参照（GUID）を自動で置き換えるため、PrefabやAnimator Controllerなどの参照エラー（Missing）を起こさずにプロジェクトのクリーンアップが可能です。

DuplicateMergerとDuplicateCleanerの2種類のToolsが含まれます！

何か気になることがありましたらお気軽にご連絡お願いします！

UnityAssetsStoreへの出品は遅れていますので公開され次第お知らせさせていただきます。

+++ 内容物 +++

[DuplicaterTools_V1.1.unitypackage]

AssetReferenceUtils.cs

DuplicateCleaner.cs

DuplicateMerger.cs

(支援版には初期作成バージョン、過去バージョンが含まれます)

[取扱説明書.txt]

+++ 機能 +++

・厳密な重複スキャン (Duplicate Cleaner): ファイルサイズとMD5ハッシュ値を用いて、完全に一致するファイルを自動検索します。

・柔軟な自動選択機能: 「パスが一番短い」「被参照数が最も多い」「一番新しいファイル」などのルールで、維持するアセットを自動判定できます。

・手動統合モード (Duplicate Merger): ユーザーが任意に選択した複数のアセットを、ドラッグ＆ドロップで指定した単一のアセットに統合する機能も搭載しています。

・安全な参照置換: 削除するアセットへの参照を、維持するアセットへ自動置換します。(.prefab, .mat, .controller, .anim, .unity 等に対応)

+++ 注意事項 +++

ツールを実行する前に、以下の仕様を必ずご確認ください！

・バックアップの推奨: 操作は Ctrl+Z (Undo) で元に戻すことができません。

実行前には必ずプロジェクトのバックアップを作成するか、Git等でコミットを行ってください 。

・Force Text シリアライズの必須化: バイナリ形式のままアセットのGUIDを書き換えるとファイルが破損するため、プロジェクト設定が「Force Text」である必要があります 。

未設定の場合は実行時に確認ダイアログが表示されます 。

・ C#スクリプトのハードコードは置換対象外: 参照置換の対象は .prefab、.unity、.mat などの特定拡張子に限定されています 。C#スクリプト内でアセットパスやGUIDを文字列として直接記述している場合、書き換えられずにエラーの原因になる可能性があるためご注意ください 。

+++ DuplicateCleanerの使用方法 +++

プロジェクト全体や指定フォルダをスキャンし、中身が全く同じ重複ファイルを自動検索して一括で統合＆削除を行うツールです 。

1.スキャン条件の設定と実行

・検索対象のフォルダパス（デフォルトは Assets/）を追加・削除して指定します 。

・スキャンから除外したい拡張子（例: .cginc）を指定します。

・「指定フォルダをスキャン」または「プロジェクト全体をスキャン」ボタンを押すと、ファイルサイズとハッシュ値に基づく厳密な重複チェックが始まります。

2.残すアセットの選択（自動または手動）

・スキャン完了後、重複しているアセットがグループごとに一覧表示されます 。

・自動選択: 画面上部のプルダウンから「パスが一番短い」「一番新しいファイル」「被参照数が最も多い」などのルールを選び、「自動選択を適用」を押すことで、各グループで残すべきアセットを自動判定できます 。

・個別設定: 必要に応じて、グループごとに「✅ 維持（残すファイル）」「❌ 削除（消すファイル）」「⚠️ スキップ（何もしない）」を手動で切り替えることも可能です。

3.統合の実行

・画面下部の「選択したグループを統合する...」ボタンを押します 。

・最終確認ウィンドウが表示されるため、内容を確認して実行すると、参照の置き換えと不要ファイルの削除が完了します。

+++ DuplicateMergerの使用方法 +++

任意で選択した複数のアセットを、指定した単一のアセットへ手動で統合するためのツールです。

1.ベースとなるアセットの指定

・「維持するアセット (A)」の項目に、統合後もプロジェクトに残すベースアセットを指定します。

2.削除・統合するアセットの追加

・「統合・削除するアセット (B)」のリストに、(A) に統合して消去したいアセットを追加します 。

・Projectウィンドウから該当エリアへアセットを直接ドラッグ＆ドロップして追加することも可能です 。

※「開発者モード」にチェックを入れると、通常は制限されている「異なる拡張子同士のアセットの統合」が可能になりますが、意図しない動作を招く可能性があるため上級者向けとされています。

3.統合の実行

・「選択した全てのアセット(B)を(A)に統合する」ボタンを押します。

・プロジェクト内の (B) に対する参照がすべて (A) に置き換わり、その後 (B) が削除されます。

+++ 動作環境 +++

Unity 2019.4 LTS 以降のバージョンでの動作を想定しています。

Unity 2022.3.22f1 動作確認済み

※注意点: プロジェクトのシリアライズ設定が「Force Text」である必要があります。（未設定の場合はツール実行時に変更を促すダイアログが表示されます。）

+++ 利用規約 +++

本Editor拡張は kumiiiiiV (頭蓋骨クミ#7230) によって制作されました。

再配布: Editorファイル,Unitypackageなどの再配布は固く禁じます。

著作権表示: Editorの著作権はkumiiiiiVに帰属します。クレジット表記は任意ですが、していただけると大変励みになります。

免責事項: 本Editorの使用によって発生したいかなる損害についても、作者は一切の責任を負いません。自己責任においてご使用ください。本ツールの操作はUndo（取り消し）できないため、必ずプロジェクトのバックアップを取った上で自己責任においてご使用ください。

+++ サポート +++

本Editor拡張に関する不具合報告や、機能に関するご質問は、作者のDiscord[ID:kumiiiiiV]までご連絡ください

+++ 更新履歴 +++

2026/5/28

DuplicaterTools_V1.1

商品公開