refactor: reorganize engine-based structure and add agent rules
- Engines/ 配下へエンジン別に再編 (Common/Rgss/Tkool/Tyrano/Wolf/Unity/Nwjs) - ゲーム個別処理を Engines/<Engine>/Games/<GameName>/ へ分離し、共通処理から明示呼び出し - 外部ツールを Engines/<Engine>/Tools/ へ移動し、AppPathHelper 経由で解決 - 旧 Tools/ 直下参照と不要な参照ファイル/バックアップを削除 - エージェント規則 AGENTS.md を追加し、README から参照 - publish.ps1 を Engines/<Engine>/Tools/ の再帰配置に対応
This commit is contained in:
1 parent
0d11039ee9
commit
8cea2a147d
47 files changed
+2976
-176
No files matched your search
@@ -3,6 +3,81 @@
|
||||
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/<Engine>/` 配下にサービス・モデルをまとめる。
|
||||
- **ゲーム個別対応はエンジン配下に隔離**: 特定ゲーム専用の改造は `Engines/<Engine>/Games/<GameName>/` に配置し、共通処理から **明示的に呼び出す**。他ゲームへ影響しないことを保証する。
|
||||
- **外部ツールもエンジン別**: 外部ツール・外部ファイルは `Engines/<Engine>/Tools/` に配置し、`AppPathHelper.ResolveEngineTool(engine, fileName)` で解決する。エンジン間でツールを共有しない。
|
||||
|
||||
---
|
||||
|
||||
## 🌟 主な機能一覧
|
||||
@@ -52,6 +127,23 @@ RPGツクール(MV・MZ)、ティラノスクリプト、およびUnity製
|
||||
|
||||
---
|
||||
|
||||
## 🧩 新しいエンジンを追加する手順
|
||||
|
||||
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`)
|
||||
@@ -68,9 +160,11 @@ RPGツクール(MV・MZ)、ティラノスクリプト、およびUnity製
|
||||
- **プロファイル格納先**: `Z:\自作ソフト\GameLauncher\Profiles\`
|
||||
- **セーブバックアップ先**: `Z:\自作ソフト\GameLauncher\Backups\`
|
||||
- **プラグイン格納先**: `Z:\自作ソフト\GameLauncher\plugins\`
|
||||
- **エンジン別ツール**: `Z:\自作ソフト\GameLauncher\Engines\<Engine>\Tools\`
|
||||
|
||||
### 発行方法
|
||||
`publish.bat` または `publish.ps1` を実行することで、自動的に単一ファイルとして `Z:\自作ソフト\GameLauncher\` に出力されます。
|
||||
`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"
|
||||
```
|
||||
Reference in new issue
Block a user