armonica b65122537d 機能追加: メモリ上でのディレクトリ・ファイル高速判定用スナップショットクラスを追加
Everything や NTFS MFT から取得したファイルツリーをインメモリで保持し、ディスクI/Oを行わずにファイル存在確認や一覧取得を可能にする FastDirectorySnapshot クラスを実装しました。
2026-10-20 11:29:53 +09:00

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 復元(元状態に戻す)
  • 動的スクリプト改造(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 を同梱しています。


🧩 新しいエンジンを追加する手順

  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/ 配下の外部ツールも併せて配置します)

dotnet publish "c:\VS2026\GameLauncher\GameLauncher.csproj" -c Release -r win-x64 --self-contained false -o "Z:\自作ソフト\GameLauncher"
S
Description
Game Launcher Application
Readme
8.6 MiB
0 Stars 1 Watchers 0 Forks
Languages
C# 95.6%
JavaScript 4.1%
PowerShell 0.3%