chore: bundle evbunpack tool and add EVB control/launch fixes

- Add Enigma Virtual Box (EVB) engine support: detection, badge, unpack/restore UI
- Bundle evbunpack.exe under Engines/Evb/Tools/evbunpack (Apache-2.0, with LICENSE/README)
- Copy Engines\\**\\Tools\\** to build output via csproj (publish already covered by publish.ps1)
- Throttle evbunpack progress reporting and shorten timeout to stop UI freeze
- Rename original packed exe to .glbak and write a completion marker; make Restore reverse it
- Launch the unpacked exe from _evb_extracted so script mods apply
- Replace EVB MessageBox dialogs with readable log summaries
- Remove obsolete boxed/7zip extraction code (NwjsPackageUnpacker, TkoolPackagedExtractionService)
This commit is contained in:
armonica committed 2026-10-07 09:30:09 +09:00
1 parent 8cea2a147d
commit 05e7bdb3c0
23 files changed
+1542 -1288

No files matched your search

-378
View File
@@ -1,378 +0,0 @@
using System;
using System.IO;
using System.IO.Compression;
using System.Linq;
using System.Security.Cryptography;
namespace GameLauncher.Engines.Nwjs
{
/// <summary>
/// nw.js 系(boxed / FOSSIL 等の単体exe梱包)ツクールゲームから、
/// 埋め込まれた package.nw 相当のコンテナを抽出する汎用アンパッカー。
///
/// 方針(恒久・再利用可能):
/// - 特定ゲーム専用ではなく、共通の署名探索アルゴリズムで「埋め込みZIPコンテナ」を探す。
/// - exe 全体を一括読みしない。ブロック単位の逐次走査で PK ローカルヘッダ→EOCD を確定する。
/// - 抽出先はゲームフォルダ内 `_extracted` のみ(他ゲームへ一切影響しない)。
/// - 冪等: 既に展開済み(plugins.js が解決できる)なら再展開しない。
///
/// 抽出戦略は <see cref="INwjsUnpackStrategy"/> として差し替え可能にしてあり、
/// 将来新しい梱包形式が出た場合は戦略を追加するだけで拡張できる。
/// </summary>
public static class NwjsPackageUnpacker
{
/// <summary>ゲームフォルダ内の展開先フォルダ名(Asar/SRPG の慣習に合わせる)</summary>
public const string ExtractedDirName = "_extracted";
/// <summary>走査ブロックサイズ(1ブロックあたりの読み込み量)</summary>
private const int ScanBlockSize = 4 * 1024 * 1024;
/// <summary>単一のPKローカルヘッダから読み込める最大ウィンドウ(EOCD 探索用)</summary>
private const int MaxSingleZipScan = 256 * 1024 * 1024;
/// <summary>ゲームフォルダ内の展開先ディレクトリ(物理パス)</summary>
public static string GetExtractedDir(string gameRootDir)
=> Path.Combine(gameRootDir, ExtractedDirName);
/// <summary>
/// 展開先 `_extracted` に js/plugins.js(または www/js/plugins.js)が存在するか判定します。
/// </summary>
public static bool IsExtractionComplete(string extractedDir, out string? pluginsJsPath, out string? relativePlugins)
{
pluginsJsPath = null;
relativePlugins = null;
try
{
var candidates = new[]
{
new { Abs = Path.Combine(extractedDir, "js", "plugins.js"), Rel = "js/plugins.js" },
new { Abs = Path.Combine(extractedDir, "js", "plugins", "plugins.js"), Rel = "js/plugins/plugins.js" },
new { Abs = Path.Combine(extractedDir, "www", "js", "plugins.js"), Rel = "www/js/plugins.js" },
};
foreach (var c in candidates)
{
if (File.Exists(c.Abs))
{
pluginsJsPath = c.Abs;
relativePlugins = c.Rel;
return true;
}
}
}
catch { }
return false;
}
/// <summary>
/// 指定パス直下から js/plugins.js を解決します(_extracted 配下優先)。
/// </summary>
public static string? ResolvePluginsJs(string rootDir)
{
try
{
var candidates = new[]
{
Path.Combine(rootDir, "js", "plugins.js"),
Path.Combine(rootDir, "js", "plugins", "plugins.js"),
Path.Combine(rootDir, "www", "js", "plugins.js"),
Path.Combine(rootDir, "package.nw", "js", "plugins.js"),
};
return candidates.FirstOrDefault(File.Exists);
}
catch
{
return null;
}
}
/// <summary>
/// 判定に必要な署名情報。汎用の埋め込みZIPコンテナ有無を表します。
/// </summary>
public sealed class EmbeddedZipProbeResult
{
/// <summary>PK ローカルヘッダ(PK\x03\x04)の先頭オフセット(見つかった場合)</summary>
public long? LocalHeaderOffset { get; init; }
/// <summary>EOCD(PK\x05\x06)の末尾オフセット(見つかった場合)</summary>
public long? EocdOffset { get; init; }
/// <summary>コンテナ内に package.json 文字列が見つかったか</summary>
public bool HasPackageJson { get; init; }
/// <summary>標準ZIPとして展開可能そうか</summary>
public bool IsZipExtractable => LocalHeaderOffset.HasValue && EocdOffset.HasValue;
}
/// <summary>
/// 埋め込みコンテナ(package.nw = 標準ZIP)を逐次走査で探索します。全走査でも
/// exe を一括メモリへ載せないため、1.14GB級でも安全です。
/// </summary>
/// <param name="exePath">対象の単体exeパス</param>
/// <param name="progress">進捗通知(任意)</param>
/// <param name="maxScanBytes">先頭から走査する最大バイト数(既定は末尾まで)</param>
public static EmbeddedZipProbeResult ProbeEmbeddedZip(string exePath, IProgress<string>? progress = null, long maxScanBytes = long.MaxValue)
{
if (!File.Exists(exePath))
{
return new EmbeddedZipProbeResult();
}
long? localHeader = null;
bool hasPackageJson = false;
using var fs = new FileStream(exePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
long fileSize = fs.Length;
long scanLimit = Math.Min(fileSize, maxScanBytes);
var buf = new byte[ScanBlockSize];
long pos = 0;
// ブロック境界をまたぐPK検出のため、直前3バイトを保持する
int carry = 0;
byte b1 = 0, b2 = 0, b3 = 0;
progress?.Report($"埋め込みZIPコンテナを走査中... ({fileSize:N0} bytes)");
while (pos < scanLimit)
{
int toRead = (int)Math.Min(buf.Length, scanLimit - pos);
fs.Seek(pos, SeekOrigin.Begin);
int read = fs.Read(buf, 0, toRead);
if (read <= 0)
{
break;
}
for (int i = 0; i < read; i++)
{
byte cur = buf[i];
if (carry == 3 && b1 == 0x50 && b2 == 0x4B && b3 == 0x03 && cur == 0x04 && localHeader == null)
{
// ローカルヘッダ先頭位置 = (今回ブロック開始 - 3) + (i - 3)
long abs = pos + i - 3;
if (abs >= 0)
{
localHeader = abs;
progress?.Report($"埋め込みZIPローカルヘッダを検出: offset={abs:N0}");
}
}
if (b1 == 0x50 && b2 == 0x4B && b3 == 0x03 && cur == 0x04)
{
b1 = b2; b2 = b3; b3 = cur;
}
else
{
b1 = b2; b2 = b3; b3 = cur;
}
if (carry < 3)
{
carry++;
}
}
// ブロック内で package.json 文字列を軽く探索(タイトル推定用・厳密性は不要)
if (!hasPackageJson)
{
var ascii = System.Text.Encoding.ASCII.GetString(buf, 0, read);
if (ascii.IndexOf("package.json", StringComparison.Ordinal) >= 0)
{
hasPackageJson = true;
}
}
pos += read;
progress?.Report($"走査中... {pos:N0} / {fileSize:N0} bytes");
}
// EOCD(PK\x05\x06)は末尾近傍にある。末尾 64KB を走査。
long? eocd = null;
if (localHeader.HasValue)
{
int tailLen = (int)Math.Min(64 * 1024, fileSize);
var tail = new byte[tailLen];
fs.Seek(fileSize - tailLen, SeekOrigin.Begin);
int tr = fs.Read(tail, 0, tailLen);
for (int i = tr - 4; i >= 0; i--)
{
if (tail[i] == 0x50 && tail[i + 1] == 0x4B && tail[i + 2] == 0x05 && tail[i + 3] == 0x06)
{
eocd = (fileSize - tailLen) + i;
break;
}
}
// 末尾64KBに無ければローカルヘッダ以降の限定ウィンドウも確認(巨大な付加データ対策)
if (eocd == null)
{
eocd = FindEocdNearOffset(fs, localHeader.Value, fileSize);
}
}
return new EmbeddedZipProbeResult
{
LocalHeaderOffset = localHeader,
EocdOffset = eocd,
HasPackageJson = hasPackageJson
};
}
/// <summary>
/// ローカルヘッダ以降を(最大<see cref="MaxSingleZipScan"/>まで)限定走査し、EOCD 位置を探します。
/// </summary>
private static long? FindEocdNearOffset(FileStream fs, long start, long fileSize)
{
long limit = Math.Min(fileSize, start + MaxSingleZipScan);
// 末尾から逆方向に少しずつ探す方が現実的だが、境界が読めない場合は後方優先で探す
long window = 4 * 1024 * 1024;
for (long end = limit; end > start; end -= window)
{
long begin = Math.Max(start, end - window);
int len = (int)(end - begin);
if (len <= 4)
{
continue;
}
var buf = new byte[len];
fs.Seek(begin, SeekOrigin.Begin);
int read = fs.Read(buf, 0, len);
for (int i = read - 4; i >= 0; i--)
{
if (buf[i] == 0x50 && buf[i + 1] == 0x4B && buf[i + 2] == 0x05 && buf[i + 3] == 0x06)
{
return begin + i;
}
}
}
return null;
}
/// <summary>
/// exe 内に埋め込まれた ZIP(package.nw)を、指定の展開先へ冪等に全展開します。
/// 標準ZIPとして解釈できる場合のみ成功します。
/// </summary>
/// <returns>展開後の js/plugins.js の相対パス(/区切り)。解決できなければ null。</returns>
public static string? ExtractEmbeddedZip(string exePath, string destDir, IProgress<string>? progress = null)
{
try
{
var probe = ProbeEmbeddedZip(exePath, progress);
if (!probe.IsZipExtractable)
{
progress?.Report("埋め込みZIPコンテナを確定できませんでした(非標準コンテナの可能性)。");
return null;
}
Directory.CreateDirectory(destDir);
using var fs = new FileStream(exePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
long zipLength = probe.EocdOffset!.Value + 22 - probe.LocalHeaderOffset!.Value;
fs.Seek(probe.LocalHeaderOffset!.Value, SeekOrigin.Begin);
// EOCD を含む範囲だけを ZipArchive へ渡す(exe 末尾の付加データを切り離す)
using var slice = new SubStream(fs, probe.LocalHeaderOffset!.Value, zipLength);
using var zip = new ZipArchive(slice, ZipArchiveMode.Read);
foreach (var entry in zip.Entries)
{
var entryRel = entry.FullName.Replace('/', Path.DirectorySeparatorChar);
var dest = Path.Combine(destDir, entryRel);
// ディレクトリエントリ
if (string.IsNullOrEmpty(entry.Name))
{
Directory.CreateDirectory(dest);
continue;
}
var parent = Path.GetDirectoryName(dest);
if (!string.IsNullOrEmpty(parent))
{
Directory.CreateDirectory(parent);
}
using (var src = entry.Open())
using (var outFs = new FileStream(dest, FileMode.Create, FileAccess.Write, FileShare.None))
{
src.CopyTo(outFs);
}
}
progress?.Report("埋め込みZIPコンテナの展開が完了しました。");
return IsExtractionComplete(destDir, out _, out var rel) ? rel : null;
}
catch (Exception ex)
{
progress?.Report($"埋め込みZIP展開中にエラーが発生しました: {ex.Message}");
return null;
}
}
/// <summary>
/// 指定範囲のみを読み出す読み取り専用ストリーム(ZIP末尾の付加データ分離用)。
/// </summary>
private sealed class SubStream : Stream
{
private readonly Stream _base;
private readonly long _start;
private readonly long _length;
private long _pos;
public SubStream(Stream baseStream, long start, long length)
{
_base = baseStream;
_start = start;
_length = length;
}
public override bool CanRead => true;
public override bool CanSeek => true;
public override bool CanWrite => false;
public override long Length => _length;
public override long Position
{
get => _pos;
set => _pos = value;
}
public override int Read(byte[] buffer, int offset, int count)
{
long remaining = _length - _pos;
if (remaining <= 0)
{
return 0;
}
int toRead = (int)Math.Min(count, remaining);
_base.Seek(_start + _pos, SeekOrigin.Begin);
int read = _base.Read(buffer, offset, toRead);
_pos += read;
return read;
}
public override long Seek(long offset, SeekOrigin origin)
{
_pos = origin switch
{
SeekOrigin.Begin => offset,
SeekOrigin.Current => _pos + offset,
SeekOrigin.End => _length + offset,
_ => _pos
};
return _pos;
}
public override void Flush() { }
public override void SetLength(long value) => throw new NotSupportedException();
public override void Write(byte[] buffer, int offset, int count) => throw new NotSupportedException();
}
/// <summary>
/// 抽出戦略の抽象。標準ZIP以外の独自コンテナが出た場合に差し替え可能にするための骨組み。
/// </summary>
public interface INwjsUnpackStrategy
{
string Name { get; }
bool CanHandle(string exePath);
string? Extract(string exePath, string destDir, IProgress<string>? progress);
}
}
}
-341
View File
@@ -1,341 +0,0 @@
using System;
using System.Diagnostics;
using System.IO;
using System.IO.Compression;
using System.Linq;
using System.Net.Http;
using System.Threading;
using System.Threading.Tasks;
using GameLauncher.Helpers;
namespace GameLauncher.Engines.Nwjs
{
/// <summary>
/// nw.js 埋め込み package.nw を抽出する外部アンパッカーツールの供給・呼び出しを担う汎用プロバイダ。
///
/// 設計方針(恒久・再利用可能):
/// - ツールは `Engines\Nwjs\Tools\` 配下に配置する(エンジン別のツールフォルダ)。
/// - 未配置の場合は初回利用時に自動ダウンロードして同フォルダへ展開する(ユーザー確認なし)。
/// - ネット未接続等で入手できない場合は、例外を投げず null を返して「起動のみ」にフォールバックさせる。
/// - 特定ゲーム専用の決め打ちは禁止。呼び出し規約(引数・出力ディレクトリ)は汎用に扱う。
///
/// 外部ツールは「7-Zip 互換のコマンドライン(-o/-y で展開)」を持つものを第一候補とし、
/// 追加の抽出戦略が増えた場合も同じ呼び出しインターフェースで扱えるようにしてある。
/// </summary>
public static class NwjsUnpackerToolProvider
{
/// <summary>Engine identifier used to resolve the per-engine tools folder.</summary>
public const string EngineName = "Nwjs";
/// <summary>Fallback tools folder name (legacy layout).</summary>
public const string ToolsDirName = "Tools";
/// <summary>外部アンパッカーの実行ファイル名(Tools 配下へ配置する想定)</summary>
public const string DefaultToolExeName = "7z.exe";
/// <summary>
/// 外部ツールの入手元 URL(7-Zip 公式・Windows x64 版)。ダウンロード後に展開して
/// 7z.exe / 7z.dll のみを Tools 配下へ配置します。
/// </summary>
private static readonly string[] ToolArchiveUrls =
{
"https://www.7-zip.org/a/7zr.exe", // 単体実行版(依存 DLL 不要)
"https://www.7-zip.org/a/7z2408-extra.7z", // 予備(extra パッケージ)
};
/// <summary>
/// Returns the engine-specific tools directory (Engines\Nwjs\Tools).
/// Each engine references only its own tools folder, so the NW.js
/// unpacker never depends on another engine's files.
/// </summary>
public static string GetToolsDirectory()
{
return AppPathHelper.GetEngineToolsDirectory(EngineName);
}
/// <summary>配置済みの外部アンパッカー exe のフルパスを取得します(無ければ null)。</summary>
public static string? GetToolPath()
{
try
{
var tools = GetToolsDirectory();
// 優先順: 7zr(単体)→ 7z → 汎用名
var candidates = new[]
{
Path.Combine(tools, "7zr.exe"),
Path.Combine(tools, DefaultToolExeName),
Path.Combine(tools, "nwjs-unpack.exe"),
};
return candidates.FirstOrDefault(File.Exists);
}
catch
{
return null;
}
}
/// <summary>
/// 外部アンパッカーの可用性を判定します。
/// </summary>
public static bool IsToolAvailable() => GetToolPath() != null;
/// <summary>
/// 外部アンパッカーが未配置の場合、初回利用時に自動ダウンロードして Tools 配下へ配置します。
/// 失敗(ネット未接続等)時は例外を投げず false を返します。
/// </summary>
public static async Task<bool> EnsureToolAvailableAsync(IProgress<string>? progress = null, CancellationToken ct = default)
{
if (IsToolAvailable())
{
return true;
}
try
{
var tools = GetToolsDirectory();
Directory.CreateDirectory(tools);
foreach (var url in ToolArchiveUrls)
{
try
{
progress?.Report($"外部アンパッカーを取得中: {url}");
var fileName = Path.GetFileName(new Uri(url).LocalPath);
var dest = Path.Combine(tools, fileName);
if (!await DownloadFileAsync(url, dest, progress, ct).ConfigureAwait(false))
{
continue;
}
// 単体実行版(7zr.exe)はそのまま配置
if (fileName.EndsWith(".exe", StringComparison.OrdinalIgnoreCase))
{
progress?.Report($"外部アンパッカーを配置しました: {dest}");
return IsToolAvailable();
}
// .7z アーカイブの場合は 7zr で本体を抽出(可能な範囲で)
// 7zr.exe が既に同梱されていればそれを使い、無ければ諦めて次URLへ。
progress?.Report("アーカイブを展開して本体を配置します...");
if (TryExpandArchive(dest, tools, progress))
{
return IsToolAvailable();
}
}
catch (Exception ex)
{
progress?.Report($"取得元の処理に失敗しました(次候補を試行): {ex.Message}");
}
}
}
catch (Exception ex)
{
progress?.Report($"外部アンパッカーの取得に失敗しました: {ex.Message}");
}
return IsToolAvailable();
}
private static async Task<bool> DownloadFileAsync(string url, string dest, IProgress<string>? progress, CancellationToken ct)
{
try
{
using var http = new HttpClient { Timeout = TimeSpan.FromMinutes(5) };
using var resp = await http.GetAsync(url, HttpCompletionOption.ResponseHeadersRead, ct).ConfigureAwait(false);
if (!resp.IsSuccessStatusCode)
{
progress?.Report($"ダウンロード失敗 (HTTP {(int)resp.StatusCode}): {url}");
return false;
}
var total = resp.Content.Headers.ContentLength ?? -1;
await using var src = await resp.Content.ReadAsStreamAsync(ct).ConfigureAwait(false);
await using var outFs = new FileStream(dest, FileMode.Create, FileAccess.Write, FileShare.None);
var buf = new byte[81920];
long written = 0;
int read;
while ((read = await src.ReadAsync(buf, ct).ConfigureAwait(false)) > 0)
{
await outFs.WriteAsync(buf.AsMemory(0, read), ct).ConfigureAwait(false);
written += read;
if (total > 0)
{
progress?.Report($"ダウンロード中... {written * 100 / total}%");
}
}
return File.Exists(dest) && new FileInfo(dest).Length > 0;
}
catch (Exception ex)
{
progress?.Report($"ダウンロードに失敗しました: {ex.Message}");
return false;
}
}
/// <summary>
/// ダウンロードした .7z / .zip アーカイブから 7z.exe / 7zr.exe を Tools へ配置します。
/// ZIP は .NET 標準で、.7z は既存 7zr.exe がある場合のみ実行します。
/// </summary>
private static bool TryExpandArchive(string archivePath, string toolsDir, IProgress<string>? progress)
{
try
{
if (archivePath.EndsWith(".zip", StringComparison.OrdinalIgnoreCase))
{
using var zip = ZipFile.OpenRead(archivePath);
foreach (var entry in zip.Entries)
{
var name = Path.GetFileName(entry.FullName);
if (name.Equals("7zr.exe", StringComparison.OrdinalIgnoreCase) ||
name.Equals("7z.exe", StringComparison.OrdinalIgnoreCase) ||
name.Equals("7z.dll", StringComparison.OrdinalIgnoreCase))
{
var dest = Path.Combine(toolsDir, name);
entry.ExtractToFile(dest, overwrite: true);
}
}
return IsToolAvailable();
}
// .7z は既存の 7zr.exe がある場合のみ展開を試みる
var existing = Path.Combine(toolsDir, "7zr.exe");
if (!File.Exists(existing))
{
return false;
}
var psi = new ProcessStartInfo
{
FileName = existing,
Arguments = $"x \"{archivePath}\" -o\"{toolsDir}\" -y",
WorkingDirectory = toolsDir,
CreateNoWindow = true,
UseShellExecute = false,
RedirectStandardOutput = true,
RedirectStandardError = true
};
using var proc = Process.Start(psi);
if (proc == null)
{
return false;
}
proc.StandardOutput.ReadToEnd();
proc.StandardError.ReadToEnd();
proc.WaitForExit();
return IsToolAvailable();
}
catch (Exception ex)
{
progress?.Report($"アーカイブ展開に失敗しました: {ex.Message}");
return false;
}
}
/// <summary>
/// 外部アンパッカーで exe 内の埋め込みコンテナ(package.nw 等)を destDir へ全展開します。
/// 呼び出し規約は「7-Zip 互換: &lt;tool&gt; x &lt;archive&gt; -o&lt;out&gt; -y」を第一候補、
/// 対応しない場合は 2 番目の規約(&lt;tool&gt; &lt;archive&gt; -o &lt;out&gt;)へフォールバックします。
/// </summary>
/// <returns>成功時 true(destDir に何らかのファイルが展開された場合)。</returns>
public static bool ExtractWithExternalTool(string toolPath, string sourceExePath, string destDir, IProgress<string>? progress = null, int timeoutMs = 30 * 60 * 1000)
{
try
{
Directory.CreateDirectory(destDir);
// 規約1: 7-Zip 互換
if (RunTool(toolPath, $"x \"{sourceExePath}\" -o\"{destDir}\" -y", destDir, progress, timeoutMs, out var code1))
{
if (HasAnyExtractedFile(destDir))
{
return true;
}
}
progress?.Report($"外部ツール規約1の出力が空でした (code={code1})。規約2を試行します。");
// 規約2: <tool> <archive> -o <out>
if (RunTool(toolPath, $"\"{sourceExePath}\" -o \"{destDir}\"", destDir, progress, timeoutMs, out var code2))
{
if (HasAnyExtractedFile(destDir))
{
return true;
}
}
progress?.Report($"外部ツールでの展開に失敗しました (code1={code1}, code2={code2})。");
return false;
}
catch (Exception ex)
{
progress?.Report($"外部ツール実行中にエラーが発生しました: {ex.Message}");
return false;
}
}
private static bool RunTool(string toolPath, string args, string workDir, IProgress<string>? progress, int timeoutMs, out int exitCode)
{
exitCode = -1;
try
{
var psi = new ProcessStartInfo
{
FileName = toolPath,
Arguments = args,
WorkingDirectory = workDir,
CreateNoWindow = true,
UseShellExecute = false,
RedirectStandardOutput = true,
RedirectStandardError = true
};
using var proc = Process.Start(psi);
if (proc == null)
{
return false;
}
// 出力を読み切ってから待機(デッドロック回避)
var stdout = proc.StandardOutput.ReadToEnd();
var stderr = proc.StandardError.ReadToEnd();
if (!proc.WaitForExit(timeoutMs))
{
try { proc.Kill(entireProcessTree: true); } catch { }
progress?.Report("外部ツールがタイムアウトしました。");
return false;
}
exitCode = proc.ExitCode;
if (!string.IsNullOrWhiteSpace(stdout))
{
progress?.Report(stdout.Trim());
}
if (!string.IsNullOrWhiteSpace(stderr))
{
progress?.Report($"[stderr] {stderr.Trim()}");
}
return exitCode == 0;
}
catch (Exception ex)
{
progress?.Report($"外部ツール起動に失敗しました: {ex.Message}");
return false;
}
}
private static bool HasAnyExtractedFile(string dir)
{
try
{
return Directory.Exists(dir) && Directory.EnumerateFileSystemEntries(dir).Any();
}
catch
{
return false;
}
}
}
}
@@ -1,33 +0,0 @@
# 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)に従ってください。