Files

193 lines
13 KiB
Markdown
Raw Permalink 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.
# 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"
```