- 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)
13 KiB
13 KiB
GameLauncher (ツクールMV・MZ・ティラノ & Unity 統合ゲームランチャー)
RPGツクール(MV・MZ)、ティラノスクリプト、およびUnity製ゲームを1つの洗練された画面で一元管理・高速起動できる統合ランチャーです。 従来の TkoolLauncher と UnityLauncher の全機能(スクリプト改造、ASAR解凍・復元、PlayerPrefsレジストリ編集、セーブファイル編集、バックアップ)が欠けることなく完全に統合されています。
📌 AI エージェント / 開発者向け規則: 本プロジェクトでの変更は必ず
AGENTS.mdに従ってください(エンジン別構成・ゲーム個別対応の隔離・外部ツールのエンジン別配置など)。
📁 フォルダ構成(エンジン別アーキテクチャ)
エンジンごとに処理を統一し、ゲーム専用の改造が他ゲームへ影響しないよう、エンジン別フォルダで完全に分離しています。
GameLauncher/
├── Engines/ … エンジン別の処理(エンジンごとに独立)
│ ├── Common/ … 全エンジン共通の基盤
│ │ ├── IEngineModule.cs … エンジン共通インターフェース
│ │ └── EngineDetectionHelper.cs … エンジン判定・誤検出補正
│ ├── Rgss/ … RPGツクールVX/VX Ace (RGSS) / SRPG Studio
│ │ ├── RgssModService.cs … スクリプト改造 (Scripts.rvdata2)
│ │ ├── SrpgModService.cs … SRPG Studio 改造
│ │ ├── SrpgArchiveService.cs … data.dts 解凍・再構築
│ │ ├── Games/ … ゲーム個別対応
│ │ │ └── IiniTitleRepair/ … Game.ini タイトル文字化け修復
│ │ └── Tools/ … エンジン専用ツール
│ │ └── SRPG_Unpacker.exe
│ ├── Tkool/ … RPGツクールMV/MZ (NW.js)
│ │ ├── TkoolModService.cs
│ │ ├── TkoolInjectionService.cs
│ │ ├── TkoolGameItem.cs
│ │ ├── Games/ … ゲーム個別対応
│ │ └── Tools/ … エンジン専用ツール
│ ├── Tyrano/ … ティラノスクリプト
│ │ ├── TyranoModService.cs
│ │ ├── Games/
│ │ └── Tools/
│ ├── Wolf/ … WOLF RPGエディター(ウディタ)
│ │ ├── WolfModService.cs
│ │ ├── WolfArchiveService.cs
│ │ ├── WolfSaveService.cs
│ │ ├── Games/
│ │ └── Tools/
│ │ └── UberWolfCli.exe
│ ├── Unity/ … Unity (IL2CPP / Mono)
│ │ ├── UnitySaveManagerService.cs
│ │ ├── UnityGameItem.cs / UnitySaveItem.cs / UnityEnums.cs
│ │ ├── Games/
│ │ └── Tools/
│ ├── Nwjs/ … 汎用 NW.js パッケージ / ASAR
│ │ ├── AsarArchiveService.cs
│ │ ├── Games/
│ │ └── Tools/
│ └── Evb/ … Enigma Virtual Box (EVB) パック済みゲーム
│ ├── EvbDetectionHelper.cs … PE セクション署名による EVB 検出
│ ├── EvbDetector.cs … 互換ファサード
│ ├── EvbUnpackService.cs … 解凍・復元・本来エンジン再判定
│ ├── EvbUnpackerToolProvider.cs … evbunpack 解決・引数生成
│ ├── EvbEngineModule.cs … IEngineModule 実装
│ ├── Games/ … ゲーム個別対応
│ └── Tools/
│ └── evbunpack/ … evbunpack.exe(同梱)+ README/LICENSE
├── Services/ … エンジン非依存の共通サービス
│ ├── GameScannerService.cs … ゲーム検出・キャッシュ
│ ├── SaveDataCodecManager.cs … セーブコーデック統括
│ ├── WindowResizeService.cs
│ └── Codecs/ … EasySave3 / YU-RIS コーデック
├── Models/ … エンジン非依存の共通モデル
│ ├── GameItemBase.cs
│ ├── LauncherConfig.cs
│ └── ModPluginDefinition.cs
├── Helpers/ … パス解決・コンバータ
│ ├── AppPathHelper.cs … 実行時パス・エンジン別ツール解決
│ └── Converters.cs
├── plugins/ … 改造スクリプト(JS)
├── Backups/ … セーブ・アーカイブのバックアップ
└── (UI)MainWindow / ConfigDialog / SaveEditorWindow など … WPF画面
設計原則
- エンジンごとに処理を統一: 各エンジンは
Engines/<Engine>/配下にサービス・モデルをまとめる。 - ゲーム個別対応はエンジン配下に隔離: 特定ゲーム専用の改造は
Engines/<Engine>/Games/<GameName>/に配置し、共通処理から 明示的に呼び出す。他ゲームへ影響しないことを保証する。 - 外部ツールもエンジン別: 外部ツール・外部ファイルは
Engines/<Engine>/Tools/に配置し、AppPathHelper.ResolveEngineTool(engine, fileName)で解決する。エンジン間でツールを共有しない。
🌟 主な機能一覧
1. 高速ゲーム検出 & キャッシュロード
- 対象ディレクトリ:
C:\Users\uduki\Downloads\Brave\@Game\Z:\game\R18同人\- (設定ファイル
config.jsonにより任意の追加ディレクトリに対応)
- 瞬時起動(0秒ロード):
games_cache.jsonによるキャッシュ起動と、バックグラウンドでの実在検証・差分スキャン。 - 自動インポート: 初回起動時に旧 TkoolLauncher および UnityLauncher のキャッシュを自動認識・統合インポート。
2. 直感的なUI & 切り替え
- 上部ナビゲーションタブ:
🎮⚡ すべて: 検出された全ゲームをまとめて一覧表示🎮 ツクール・ティラノ: ツクールMV/MZおよびティラノスクリプトのみに絞り込み⚡ Unity: Unity製ゲームのみに絞り込み
- インクリメンタル検索 & ソート:
- タイトル、フォルダ名、開発元(会社名・製品名)によるリアルタイム検索
- 最終実行日時(新しい順/古い順)、フォルダ更新日時(新しい順/古い順)、タイトル順、フォルダ名順でのソート
- 連動フィルター:
- ツクール選択時: MV / MZ / ティラノ / 改造中のみ / ASAR形式のみ
- Unity選択時: IL2CPP / Mono / セーブデータありのみ
3. ツクール & ティラノスクリプト機能(旧 TkoolLauncher 完全継承)
- app.asar パッケージ管理:
- Electronパッケージ(
app.asar)の自動検出とバッジ表示(圧縮 / 解凍済) - ワンクリックでの ASAR 解凍(
resources\appに展開、元ファイルを安全にリネームバックアップ) - ワンクリックでの ASAR 復元(元状態に戻す)
- Electronパッケージ(
- 動的スクリプト改造(MOD):
plugins/フォルダ内のスクリプトを動的検出し、個別ON/OFF可能- 戦闘高速化、ダッシュ速度+2、アイテム消費無効、所持金最大、経験値最大、メッセージ瞬間表示など
- ティラノスクリプト専用: 全CG・全回想の全開放、演出短縮、F12開発者ツール有効化、チートメニュー表示
- ワンクリックでのオリジナル復元(改造解除)
- プロファイルフォルダ・
plugins.jsへのクイックアクセス
4. Unity セーブデータ統合エディタ & 管理(旧 UnityLauncher 完全継承)
- セーブエディタ(SaveEditorWindow):
- PlayerPrefs(レジストリ): 数値(Int)、浮動小数点(Float)、文字列(String)、バイナリ(Hex)の直接編集・新規キー追加(MurmurHash2自動付与)・削除
- セーブファイル(LocalLow / ゲームフォルダ内): テキスト・JSONセーブデータのインライン閲覧・編集・保存・JSON整形
- 専用コーデック: EasySave3 (ES3)、YU-RIS セーブデータの自動判定・復号編集
- クイックアクセス & バックアップ:
- ゲームフォルダを開く
- LocalLow セーブフォルダを開く
- regedit で PlayerPrefs を直接開く
- セーブデータ(レジストリ & ファイル)の即時一括バックアップ(
Backups/ディレクトリ)
5. Enigma Virtual Box (EVB) パック済みゲームの解凍(Evb エンジン)
Enigma Virtual Box は汎用パッカーで、RGSS / NW.js / Wolf / Unity など どのエンジンのゲームでも 1つの exe に包めます。
Evb エンジンはこのパッケージ層を他エンジンの前段で検出し、同梱の evbunpack で解凍してから本来のエンジンを再判定します。
- 自動検出: PE セクション署名(
.enigma1/.enigma2)および埋め込みマーカー(Enigma Virtual Box)で判定。通常の(非パック)ゲームは誤検出しません。 - バッジ表示: EVB パック済みゲームには
EVBバッジを表示。未解凍のときは「要解凍」バッジも併せて表示します。 - 一目で分かるガイド: EVB ゲームを選択すると、詳細パネルに「このゲームは EVB でパックされています」という手順ガイド(①解凍 → ②本来エンジン自動判定 → ③復元可能)が表示されます。
- 解凍(📦 EVBを解凍):
- 同梱の
Engines/Evb/Tools/evbunpack/evbunpack.exeを実行し、ゲームフォルダ内_evb_extractedへ出力します。 - 解凍後、
EngineDetectionHelperにより本来のエンジン(Rgss / Tkool / Nwjs / Wolf / Unity など)を再判定します。 - 元の exe は
*.glbakとしてバックアップされ、いつでも復元できます。
- 同梱の
- 復元(↩ 解凍を元に戻す):
_evb_extractedを削除して元の状態へ戻します(元 exe のバックアップは保持)。 - 解凍ツール(
evbunpack.exe)はリポジトリ同梱です(自動ダウンロードは行いません)。詳細・出典・ライセンス・PE バリアント(-pe 10_70 / 9_70 / 7_80)はEngines/Evb/Tools/evbunpack/README.mdを参照してください。
evbunpack の出典 & ライセンス: mos9527/evbunpack(Enigma Virtual Box Unpacker、Apache-2.0、2026-02-06 にアーカイブ化)。同梱フォルダには
LICENSEを同梱しています。
🧩 新しいエンジンを追加する手順
Engines/<NewEngine>/フォルダを作成する。IEngineModule(Engines/Common/IEngineModule.cs)を実装したサービスを作成する。EngineDetectionHelperに判定ロジック・エイリアスを追加し、必要ならDetectFromDirectoryにディレクトリ特徴を追記する。- エンジン専用の外部ツールがある場合は
Engines/<NewEngine>/Tools/に配置し、AppPathHelper.ResolveEngineTool("<NewEngine>", "<tool>")で解決する。 - エンジン専用モデルは同フォルダに配置し、名前空間を
GameLauncher.Engines.<NewEngine>とする。
🎮 ゲーム個別対応を追加する手順
Engines/<Engine>/Games/<GameName>/フォルダを作成する。- 名前空間を
GameLauncher.Engines.<Engine>.Games.<GameName>とした専用クラスを作成する。 - 共通処理から 明示的に呼び出す(他ゲームには一切影響させない)。
- 可能な限りバックアップからの復元手段を用意し、後で元に戻せるようにする。
💻 動作環境 & 技術スタック
- プラットフォーム: Windows (x64)
- ターゲットフレームワーク: .NET 10.0 (
net10.0-windows) - UIフレームワーク: WPF (Windows Presentation Foundation)
- UIテーマ: ダークモダンデザイン
- 配布形態: 単一ファイル実行可能ファイル (
GameLauncher.exe)
🚀 発行(ビルド)先 & 実行方法
- プロジェクトパス:
c:\VS2026\GameLauncher - 公開先:
Z:\自作ソフト\GameLauncher\GameLauncher.exe - プロファイル格納先:
Z:\自作ソフト\GameLauncher\Profiles\ - セーブバックアップ先:
Z:\自作ソフト\GameLauncher\Backups\ - プラグイン格納先:
Z:\自作ソフト\GameLauncher\plugins\ - エンジン別ツール:
Z:\自作ソフト\GameLauncher\Engines\<Engine>\Tools\
発行方法
publish.ps1 を実行することで、自動的に単一ファイルとして Z:\自作ソフト\GameLauncher\ に出力されます。
(publish.ps1 は Engines/<Engine>/Tools/ 配下の外部ツールも併せて配置します)
dotnet publish "c:\VS2026\GameLauncher\GameLauncher.csproj" -c Release -r win-x64 --self-contained false -o "Z:\自作ソフト\GameLauncher"