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

34 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)に従ってください。