UnityProjectBackup

Unityプロジェクトを外部サービスに頼らずバックアップするためのWindows向けツールです。

Unityプロジェクト内の必要なフォルダをコピー、またはZIP圧縮して保存します。 エクスプローラの右クリックメニューから実行でき、保存先はダイアログで選択できます。

主な機能

• Unityプロジェクトのバックアップ
• 軽量バックアップ（Library を含めない）
• 通常バックアップ（Library を含める）
• フォルダコピー形式での保存
• ZIP形式での保存
• エクスプローラ右クリックメニューからの実行
• 処理中のスピナー表示
• バックアップ情報を記録する backup_manifest.json の生成

バックアップ種別

軽量バックアップ

Library フォルダを含めないバックアップです。

対象例:

Assets/
Packages/
ProjectSettings/
UserSettings/
Docs/
ResearchNotes/
ExperimentLogs/
Presentations/

特徴:

• 容量が小さい
• 長期保管に向いている
• Unityで開いたときに Library が再生成される
• 初回起動に時間がかかる場合がある

通常バックアップ

軽量バックアップの内容に加えて、Library フォルダも含めるバックアップです。

対象例:

Assets/
Packages/
ProjectSettings/
UserSettings/
Library/
Docs/
ResearchNotes/
ExperimentLogs/
Presentations/

特徴:

• 容量は大きくなる
• 復元後のUnity起動が速くなりやすい
• 同じPC・同じUnity環境での復元に向いている
• Library はUnityが再生成可能なキャッシュであるため、問題が起きた場合は削除してUnityで開き直す

コマンド

UnityProjectBackup.exe backup-light-copy <projectPath> [backupRoot] [--select-dest] [--verbose]
UnityProjectBackup.exe backup-light-zip  <projectPath> [backupRoot] [--select-dest] [--verbose]
UnityProjectBackup.exe backup-copy       <projectPath> [backupRoot] [--select-dest] [--verbose]
UnityProjectBackup.exe backup-zip        <projectPath> [backupRoot] [--select-dest] [--verbose]
UnityProjectBackup.exe install-context-menu
UnityProjectBackup.exe uninstall-context-menu

使用例

軽量ZIPバックアップ:

UnityProjectBackup.exe backup-light-zip "D:\UnityProjects\YourProject" "E:\UnityBackups"

Library を含むZIPバックアップ:

UnityProjectBackup.exe backup-zip "D:\UnityProjects\YourProject" "E:\UnityBackups"

保存先選択ダイアログを表示:

UnityProjectBackup.exe backup-zip "D:\UnityProjects\YourProject" --select-dest

詳細ログを表示:

UnityProjectBackup.exe backup-zip "D:\UnityProjects\YourProject" "E:\UnityBackups" --verbose

右クリックメニューの登録

以下のコマンドで、エクスプローラの右クリックメニューに登録します。

UnityProjectBackup.exe install-context-menu

登録後、Unityプロジェクトフォルダを右クリックすると、以下のメニューからバックアップを実行できます。

UnityProjectBackup
  軽量コピー（Libraryなし）
  軽量ZIP（Libraryなし）
  コピー（Libraryあり）
  ZIP（Libraryあり）

右クリックメニューから削除する場合:

UnityProjectBackup.exe uninstall-context-menu

出力ファイル名

バックアップ名には日時とバックアップ種別が付きます。

例:

YourProject_2026-06-24_153012_light.zip
YourProject_2026-06-24_153012_full.zip

• light: Library を含まない軽量バックアップ
• full: Library を含む通常バックアップ

ZIPの構造

ZIP内は、Unityプロジェクトとしてそのまま開ける構造になります。

Assets/
Packages/
ProjectSettings/
UserSettings/
Library/
backup_manifest.json

軽量バックアップの場合、Library/ は含まれません。

backup_manifest.json

バックアップには backup_manifest.json が含まれます。 このファイルには、バックアップ元、作成日時、バックアップ種別、対象フォルダ、ファイル数などが記録されます。

例:

{
  "projectName": "YourProject",
  "sourcePath": "D:\\UnityProjects\\YourProject",
  "createdAt": "2026-06-24T15:30:12+09:00",
  "mode": "zip",
  "profile": "Full",
  "includesLibrary": true,
  "fileCount": 12345,
  "totalBytes": 2147483648
}

注意事項

• バックアップ先はUnityプロジェクトの外側を指定してください。
• Library を含むバックアップを行う場合は、Unity Editorを閉じてから実行することを推奨します。
• Library はUnityが再生成可能なキャッシュです。
• Library を含むバックアップで復元後に問題が起きた場合は、復元先の Library フォルダを削除してUnityで開き直してください。
• Temp/, Logs/, Build/, Builds/, .vs/ などはバックアップ対象外です。
• .meta ファイルはUnityの参照関係を保つために必要なため、バックアップ対象に含まれます。

ライセンス

このソフトウェアはMITライセンスの下で提供されます。詳細はLICENSE.txtを参照してください。