﻿━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【タイトル】MZFileChecker
【Version 】1.00
【ファイル】MZFileChecker.zip
【著 作 者】（Lyrical Limited）朋美姫
【連 絡 先】ホームページ
            https://lyricallimited.blog.jp/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

《はじめに》
　　朋美姫のアプリ「MZFileChecker」をダウンロードしていただき、誠にありがとうございます！

　　本ツールは、RPGツクールMZで作成したゲームのバージョン更新時に、
　　「旧バージョン（コピー元）」と「新バージョン（確認・コピー先）」のゲームフォルダを比較し、
　　新バージョンに不足しているファイル、追加されたファイル、内容が変更されたファイル、
　　および同じ内容のファイルを確認するための支援ツールです。

　　RPGツクールMZのデプロイメント時に「未使用ファイルを除外」を使用した場合など、
　　必要な画像・音声・データファイル等が新バージョンから不足していないかを確認する用途に適しています。

　　不足ファイルは一覧から選択して旧バージョンから新バージョンへコピーでき、
　　比較結果をログとして保存することもできます。
　　また、表示言語は日本語／Englishを切り替えることができます。

《インストール方法》
　　1. 「MZFileChecker.zip」を任意の場所に解凍してください。
　　2. 解凍された「MZFileChecker.exe」を起動してください。
　　3. インストーラーによるセットアップは必要ありません。

　　※比較対象のゲームフォルダ内へ本ツールをコピーする必要はありません。
　　※旧バージョンと新バージョンのフォルダは、画面上の「参照... / Browse...」から指定できます。

《アンインストール方法》
　　本ツールのファイルを削除してください。
　　専用のアンインストーラーは必要ありません。

　　※表示言語や前回指定したフォルダ等の設定情報がWindows側に保存される場合があります。
　　　通常はそのままでも問題ありません。

《起動方法》
　　1. 「MZFileChecker.exe」をダブルクリックします。
　　2. 「旧バージョン（コピー元）のゲームフォルダ」を指定します。
　　3. 「新バージョン（確認・コピー先）のゲームフォルダ」を指定します。
　　4. 「比較する」をクリックします。

■■■使い方 / How to Use■■■

<<日本語>>

    1. 表示言語を選択
       画面右上の「表示言語」から、
       「日本語」または「English」を選択できます。

    2. 旧バージョンを指定
       「旧バージョン（コピー元）のゲームフォルダ」に、
       更新前のゲームフォルダを指定します。
       「参照...」ボタンから選択できます。

    3. 新バージョンを指定
       「新バージョン（確認・コピー先）のゲームフォルダ」に、
       更新後・確認対象となるゲームフォルダを指定します。
       「参照...」ボタンから選択できます。

    4. 「比較する」をクリック
       指定した2つのフォルダ内を比較します。
       サブフォルダも含めて確認されます。

    5. 比較結果を確認
       比較後、次の4種類の件数が表示されます。

　　　　- 新バージョンに不足しているファイル
　　　　  旧バージョンには存在するが、新バージョンには存在しないファイルです。

　　　　- 新バージョンで追加されたファイル
　　　　  新バージョンにのみ存在するファイルです。

　　　　- 内容が変更されたファイル
　　　　  両方に同じ相対パスのファイルが存在するものの、内容が異なるファイルです。

　　　　- 同じ内容のファイル
　　　　  両方に存在し、内容も同一のファイルです。

    6. 表示する結果を切り替え
       ラジオボタンから次の表示を選択できます。

　　　　- 新バージョンに不足しているファイル
　　　　- 新バージョンで追加されたファイル
　　　　- 内容が変更されたファイル
　　　　- すべての差分

       一覧には「状態」と「ファイル / 相対パス」が表示されます。

    7. 検索
       「検索」欄に文字を入力すると、表示中の比較結果を絞り込めます。

    8. ファイルを選択
       「すべて選択」で表示中の項目をまとめて選択できます。
       「選択解除」で選択を解除できます。

    9. 不足ファイルを新バージョンへコピー
       「新バージョンに不足しているファイル」を表示し、
       コピーしたいファイルを選択して
       「選択した不足ファイルを新バージョンへコピー」をクリックします。

       選択した不足ファイルが、
       旧バージョンから新バージョンの同じ相対位置へコピーされます。

       【重要】
       コピー先は新バージョンのゲームフォルダです。
       念のため、コピー実行前に新バージョン側のバックアップを作成してください。

    10. 比較結果をログに保存
        「比較結果をログに保存」をクリックすると、
        比較結果をテキストファイルとして保存できます。

【使用例】

    旧バージョン:
      C:\Games\MyGame_1.00

    新バージョン:
      C:\Games\MyGame_1.01

    比較結果:
      新バージョンに不足しているファイル: 85件
      新バージョンで追加されたファイル: 2件
      内容が変更されたファイル: 7件
      同じ内容のファイル: 1324件

    不足ファイルの例:
      img/pictures/EventCG10b.png
      img/pictures/EventCG11.png

    変更ファイルの例:
      data/Map024.json
      data/MapInfos.json
      data/System.json
      index.html
      js/plugins.js
      package.json
      説明書.txt

・主な機能 / 仕様
　　- 旧バージョンと新バージョンのフォルダ比較
　　- サブフォルダを含む再帰的な比較
　　- 不足ファイルの検出
　　- 新規追加ファイルの検出
　　- 内容が変更されたファイルの検出
　　- 同一内容ファイルの確認
　　- 差分のみの一覧表示
　　- 検索による絞り込み
　　- 複数ファイルの選択
　　- 不足ファイルを旧バージョンから新バージョンへコピー
　　- 比較結果ログの保存
　　- 日本語／英語表示切り替え
　　- 前回指定したフォルダ等の設定保存

・ご使用上の注意
　　- ファイルをコピーする前に、新バージョン側のバックアップを推奨します。
　　- 「内容が変更されたファイル」は自動的に旧版で上書きするための機能ではありません。
　　　内容を確認し、必要に応じて手動で対応してください。
　　- ゲームを起動中、または他のアプリケーションが対象ファイルを使用中の場合、
　　　コピーや比較が正常に行えない場合があります。
　　- アクセス権限のないフォルダや、書き込み禁止の場所ではコピーできない場合があります。
　　- 大量のファイルを含むゲームでは比較に時間がかかる場合があります。
　　- 本ツールはバックアップソフトではありません。重要なゲームデータは別途バックアップしてください。

<<English>>

    1. Select the display language
       Use "Language" in the upper-right corner to switch between
       "日本語" and "English".

    2. Select the old version
       In "Old version (source) game folder", select the game folder
       from before the update.
       You can select it with the "Browse..." button.

    3. Select the new version
       In "New version (check / destination) game folder", select the
       updated game folder that you want to verify.
       You can select it with the "Browse..." button.

    4. Click "Compare"
       MZFileChecker compares the two selected folders,
       including their subfolders.

    5. Review the comparison summary
       The following four totals are displayed:

　　　　- Missing in new version
　　　　  Files that exist in the old version but not in the new version.

　　　　- Added in new version
　　　　  Files that exist only in the new version.

　　　　- Modified files
　　　　  Files with the same relative path in both versions whose contents differ.

　　　　- Unchanged files
　　　　  Files that exist in both versions and have the same contents.

    6. Change the result view
       Use the radio buttons to display:

　　　　- Missing in new version
　　　　- Added in new version
　　　　- Modified files
　　　　- All differences

       The list displays the file status and relative path.

    7. Search
       Enter text in the "Search" box to filter the currently displayed results.

    8. Select files
       Click "Select all" to select the displayed items.
       Click "Clear selection" to clear the selection.

    9. Copy missing files to the new version
       Display "Missing in new version", select the files you want to restore,
       and click "Copy selected missing files to new version".

       The selected files are copied from the old version to the corresponding
       relative locations in the new version.

       IMPORTANT:
       The destination is the new-version game folder.
       We strongly recommend making a backup of the new version before copying files.

    10. Save a comparison log
        Click "Save comparison log" to save the comparison results
        as a text log file.

【Example】

    Old version:
      C:\Games\MyGame_1.00

    New version:
      C:\Games\MyGame_1.01

    Comparison summary:
      Missing in new version: 85
      Added in new version: 2
      Modified files: 7
      Unchanged files: 1324

    Examples of missing files:
      img/pictures/EventCG10b.png
      img/pictures/EventCG11.png

    Examples of modified files:
      data/Map024.json
      data/MapInfos.json
      data/System.json
      index.html
      js/plugins.js
      package.json
      Readme.txt

・Options & Features
　　- Compares old and new game-version folders
　　- Recursively checks subfolders
　　- Detects files missing from the new version
　　- Detects files added to the new version
　　- Detects files whose contents have changed
　　- Identifies unchanged files
　　- Displays all differences
　　- Filters results with the search box
　　- Supports selecting multiple results
　　- Copies selected missing files from the old version to the new version
　　- Saves comparison results as a log
　　- Japanese / English user-interface switching
　　- Remembers previously selected folders and settings

・Important Notes
　　- Back up the new-version game folder before copying files.
　　- "Modified files" are shown for review; they are not intended to be
　　  automatically overwritten with old-version files.
　　- Comparison or copying may fail if the game or another application
　　  is currently using a target file.
　　- Files cannot be copied to locations where the current Windows user
　　  does not have write permission.
　　- Comparing a game containing a very large number of files may take some time.
　　- MZFileChecker is not a backup application. Keep separate backups of
　　  important game-development data.

※MZFileChecker is designed to assist RPG Maker MZ developers when checking
  deployment results and version updates, especially when verifying that required
  files have not been omitted after using RPG Maker MZ's "Exclude Unused Files" option.

《バージョンアップ履歴 / Version History》
2026/09/27  1.00  MZFileChecker released / MZFileChecker 公開

《注意事項 / Notes》
　　- 本ツールはフリーソフトですが、著作権は朋美姫（Lyrical Limited）に帰属します。
　　- 本ツールの使用により生じたいかなる損害についても、作者は責任を負いかねます。
　　- ご使用前に重要なデータのバックアップを行ってください。
　　- 再配布はご遠慮ください。リンクを共有する場合は公式ホームページをご利用ください。
　　- バグ報告やご質問は、ホームページよりご連絡ください。

　　- This software is freeware, but the copyright belongs to
　　  Tomomi Hime (Lyrical Limited).
　　- The author assumes no responsibility for any loss or damage resulting
　　  from the use of this software.
　　- Please back up important data before using this application.
　　- Redistribution is prohibited. When sharing this software,
　　  please link to the official website.
　　- For bug reports or inquiries, please contact us through the website.

【公式ホームページ / Official Website】
　　https://lyricallimited.blog.jp/

《謝辞 / Acknowledgments》
　　本ツールの開発にあたり、RPGツクールMZコミュニティの皆様のご意見を
　　参考にさせていただきました。
　　ご利用いただくすべてのゲームクリエイターに感謝申し上げます！

　　We would like to thank the RPG Maker MZ community for the feedback and ideas
　　that helped inspire the development of this tool.
　　Thank you to all game creators who use MZFileChecker!

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
