Files
GameLauncher/Engines/Nwjs/Tools/README-nwjs-unpacker.md
T
armonica 8cea2a147d refactor: reorganize engine-based structure and add agent rules
- Engines/ 配下へエンジン別に再編 (Common/Rgss/Tkool/Tyrano/Wolf/Unity/Nwjs)
- ゲーム個別処理を Engines/<Engine>/Games/<GameName>/ へ分離し、共通処理から明示呼び出し
- 外部ツールを Engines/<Engine>/Tools/ へ移動し、AppPathHelper 経由で解決
- 旧 Tools/ 直下参照と不要な参照ファイル/バックアップを削除
- エージェント規則 AGENTS.md を追加し、README から参照
- publish.ps1 を Engines/<Engine>/Tools/ の再帰配置に対応
2026-10-07 02:30:49 +09:00

1.9 KiB
Raw Blame History

nw.js boxed 解凍用 外部アンパッカー

このフォルダには、GameLauncher が nw.js boxed 系ツクールゲーム(例: Game_boxed.exe のように ゲーム本体を exe へ内包した形態)の埋め込みコンテナ(package.nw = 標準ZIP)を展開するために 利用する外部アンパッカーを配置します。

対象

  • *boxed*.exe(nw.js 埋め込み。package.nw / package.json を含む)
  • その他、単体exeへ package.nw 相当の埋め込みZIPを持つツクール MZ/MV ゲーム

使用するツール

  • 7zr.exe(7-Zip 公式の単体実行版・依存DLL不要)を第一候補とします。
  • 代替として 7z.exe(+ 7z.dll)も検出対象です。

配置方法

  • 同梱されている場合: この Tools\ フォルダに 7zr.exe を置いてください。 publish.ps1 実行時に Z:\自作ソフト\GameLauncher\Tools\ へコピーされます。
  • 未配置の場合: GameLauncher 実行時、boxed 解凍が必要になった時点で 7-Zip 公式(https://www.7-zip.org/a/7zr.exe)から自動ダウンロードし、配置を試みます (ネット未接続などで取得に失敗した場合は「起動のみ」にフォールバックし、ゲーム自体は起動できます)。

実装上の参照

  • 取得・呼び出し: Services\NwjsUnpackerToolProvider.cs
  • 埋め込みZIP検出・展開: Services\NwjsPackageUnpacker.cs
  • オーケストレーター(戦略: 組み込みZIP → 外部ツール): Services\TkoolPackagedExtractionService.cs

呼び出し規約

  • 第一候補: 7zr.exe x "<exe>" -o"<out>" -y
  • フォールバック: 7zr.exe "<exe>" -o "<out>"

ライセンス

7-Zip は GNU LGPL + unRAR restriction の下で配布されています。 再頒布する場合は 7-Zip のライセンス条項(https://www.7-zip.org/license.txt)に従ってください。