# 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 │ │ ├── TkoolPackagedExtractionService.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 │ ├── NwjsPackageUnpacker.cs │ ├── NwjsUnpackerToolProvider.cs │ ├── AsarArchiveService.cs │ ├── Games/ │ └── Tools/ │ └── speedhack-i686/ … 倍速プロキシDLL(version.dll) ├── 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//` 配下にサービス・モデルをまとめる。 - **ゲーム個別対応はエンジン配下に隔離**: 特定ゲーム専用の改造は `Engines//Games//` に配置し、共通処理から **明示的に呼び出す**。他ゲームへ影響しないことを保証する。 - **外部ツールもエンジン別**: 外部ツール・外部ファイルは `Engines//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/` ディレクトリ) --- ## 🧩 新しいエンジンを追加する手順 1. `Engines//` フォルダを作成する。 2. `IEngineModule`(`Engines/Common/IEngineModule.cs`)を実装したサービスを作成する。 3. `EngineDetectionHelper` に判定ロジック・エイリアスを追加し、必要なら `DetectFromDirectory` にディレクトリ特徴を追記する。 4. エンジン専用の外部ツールがある場合は `Engines//Tools/` に配置し、`AppPathHelper.ResolveEngineTool("", "")` で解決する。 5. エンジン専用モデルは同フォルダに配置し、名前空間を `GameLauncher.Engines.` とする。 ## 🎮 ゲーム個別対応を追加する手順 1. `Engines//Games//` フォルダを作成する。 2. 名前空間を `GameLauncher.Engines..Games.` とした専用クラスを作成する。 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\\Tools\` ### 発行方法 `publish.ps1` を実行することで、自動的に単一ファイルとして `Z:\自作ソフト\GameLauncher\` に出力されます。 (`publish.ps1` は `Engines//Tools/` 配下の外部ツールも併せて配置します) ```powershell dotnet publish "c:\VS2026\GameLauncher\GameLauncher.csproj" -c Release -r win-x64 --self-contained false -o "Z:\自作ソフト\GameLauncher" ```