193 lines
13 KiB
Markdown
193 lines
13 KiB
Markdown
# GameLauncher (ツクールMV・MZ・ティラノ & Unity 統合ゲームランチャー)
|
||
|
||
RPGツクール(MV・MZ)、ティラノスクリプト、およびUnity製ゲームを1つの洗練された画面で一元管理・高速起動できる統合ランチャーです。
|
||
従来の **TkoolLauncher** と **UnityLauncher** の全機能(スクリプト改造、ASAR解凍・復元、PlayerPrefsレジストリ編集、セーブファイル編集、バックアップ)が欠けることなく完全に統合されています。
|
||
|
||
> 📌 **AI エージェント / 開発者向け規則**: 本プロジェクトでの変更は必ず [`AGENTS.md`](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 復元(元状態に戻す)
|
||
- **動的スクリプト改造(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`](Engines/Evb/Tools/evbunpack/README.md) を参照してください。
|
||
|
||
> **evbunpack の出典 & ライセンス**: [mos9527/evbunpack](https://github.com/mos9527/evbunpack)(Enigma Virtual Box Unpacker、Apache-2.0、2026-02-06 にアーカイブ化)。同梱フォルダには `LICENSE` を同梱しています。
|
||
|
||
---
|
||
|
||
## 🧩 新しいエンジンを追加する手順
|
||
|
||
1. `Engines/<NewEngine>/` フォルダを作成する。
|
||
2. `IEngineModule`(`Engines/Common/IEngineModule.cs`)を実装したサービスを作成する。
|
||
3. `EngineDetectionHelper` に判定ロジック・エイリアスを追加し、必要なら `DetectFromDirectory` にディレクトリ特徴を追記する。
|
||
4. エンジン専用の外部ツールがある場合は `Engines/<NewEngine>/Tools/` に配置し、`AppPathHelper.ResolveEngineTool("<NewEngine>", "<tool>")` で解決する。
|
||
5. エンジン専用モデルは同フォルダに配置し、名前空間を `GameLauncher.Engines.<NewEngine>` とする。
|
||
|
||
## 🎮 ゲーム個別対応を追加する手順
|
||
|
||
1. `Engines/<Engine>/Games/<GameName>/` フォルダを作成する。
|
||
2. 名前空間を `GameLauncher.Engines.<Engine>.Games.<GameName>` とした専用クラスを作成する。
|
||
3. 共通処理から **明示的に呼び出す**(他ゲームには一切影響させない)。
|
||
4. 可能な限りバックアップからの復元手段を用意し、後で元に戻せるようにする。
|
||
|
||
---
|
||
|
||
## 💻 動作環境 & 技術スタック
|
||
- **プラットフォーム**: 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/` 配下の外部ツールも併せて配置します)
|
||
```powershell
|
||
dotnet publish "c:\VS2026\GameLauncher\GameLauncher.csproj" -c Release -r win-x64 --self-contained false -o "Z:\自作ソフト\GameLauncher"
|
||
```
|