game-recon

ゲームの調査

約5分で、対象の状況と進むべきルートを把握します。答えを書き留め、後のすべての手順で参照できるようにします。

0. ほかのエージェントが調査済みですか？

um kb search "<game>"（およびエンジン名）を実行します。共有ナレッジベースのフィールドノートを見れば、作業可能なバージョン、ルート、注意点を、何かに手を加える前に把握できます。share-field-notes スキルを参照してください。

1. ゲームを見つけて、特徴を把握する

um scan --list                 # Steam, Epic and Xbox installs (Windows, WSL, Linux, macOS)
um scan "<name or folder>"     # host, engine, version, exes (.NET?), anti-cheat, loaders,
                               # mod folders, saves, routes
um scan "<game>" --json        # the same, machine-readable

um は universal-modder リポジトリ内の bin/um にあります（プラグインやクローンでは PATH に追加されます）。それ以外の場所では、以下を実行します。 uv tool install git+https://github.com/rehan-remade/universal-modder.

um scan はファイルを読み取るだけです。インストール先を（範囲を限定して）インデックス化し、PE ヘッダー、Unity／Godot／GameMaker のヘッダー、Unreal のバージョン文字列を検出します。既知のゲームをコミュニティ製ローダーに対応付け、確認すべきプレイブック（skills/mod-any-game/references/engines/<engine>.md）を示します。

スキャンで把握できる情報には限りがあるため、以下は手作業で確認してください。

• ゲームがストアのライブラリにない場合（GOG、itch、単体フォルダー）：フォルダーのパスを渡します。
• 複数のエンジンの兆候がある場合： ランチャーやウェブ用のヘルパーがよく原因になります。スコアが最も高いものが優先されますが、「also」の行も確認してください。
• アンチチートが別の場所にインストールされている場合： カーネルドライバー（Vanguard の vgk.sys）やランチャーレベルの保護機能は、ゲームフォルダーにありません。「 anti-cheat」を検索してください。
• オンライン専用またはライブサービスのゲーム： 何も検出されなくても、保護されているものとして扱ってください。

1b. このマシンで実行できますか？

ゲームがホスト環境向けのネイティブ版である場合は、この手順を省略します。たとえば、Windows 上または WSL から実行する Windows ゲーム、あるいは対応 OS 上の macOS 版や Linux 版です（um scan は host: と各 exe の CPU を表示し、Windows 版を別の OS で実行しようとした場合は警告します）。それ以外の場合（macOS または Linux 上で Windows 専用ゲームを実行する場合、ARM CPU で x64 ゲームを実行する場合）、またはこの環境で動くはずのゲームが起動しない場合は、まず状況とエラーの正確な文言でノートを検索します（um kb search "windows game on mac"、um kb search "proton"、um kb search "<error text>"）。その後、references/compatibility.md に従って、ホストの確認、ゲームごとのレポート、各レイヤー、アンチチート、プローブを調べます。

2. 現在のコミュニティを調査する（必ず実施。バージョンは変わります）

以下の順に検索します。

1. 「 modding」／「 mod loader」／「 modding wiki」。ゲームの Wiki に、MOD 制作のページがあることもよくあります。
2. Nexus Mods（人気の高い MOD には、依存するフレームワークが記載されています）、Thunderstore（Unity ゲーム向け：BepInEx パック）、mod.io、Steam Workshop（ゲームにあるか確認します。um scan にはインストール済みの Workshop コンテンツが表示されます）。
3. GitHub：「 mod」／「 modding api」／「 decompile」／「 sdk」／「 mod loader」。
4. 新しいフレームワークについて、最近の投稿（X／Reddit／Discord の告知）を確認します。ローダーが公開されてから数日しか経っていないこともあります。

次の情報を記録します。ローダー名、リポジトリ、現行バージョンとインストール手順、対応するゲームのバージョン、「Hello World」のサンプル MOD、ログの保存先。

3. 判断する

• 安全に MOD を導入できますか？ アンチチート、オンライン専用の要素、EULA または MOD ポリシー、ローダーが依存する所有権チェックを確認します（skills/mod-any-game/references/safety.md を参照）。安全に導入できない場合は、その旨を伝え、可能な代替案（公式ツール、オフラインモード、同じアイデアを実現できる別のゲーム）を提示します。
• ルート： ローダー API ＞ データ／アセット MOD ＞ マネージドパッチ ＞ ネイティブフック ＞ 再実装／マッシュアップ。ユーザーのアイデアを実現できる最初のルートを選びます。

4. MODDING_PLAN.md を作成する

# <Game> modding plan
- Install: <path> (<store> <appid>), version <x>
- Engine: <engine + version>, code: managed .NET / IL2CPP / native, 64-bit
- Anti-cheat / online: <none | what + verdict>
- Host / compat (if not native): <host OS, CPU, GPU> vs <game CPU + graphics API>; layer: <name + version>;
  verified by: <probe, log or screenshot>
- Saves: <path>   Config: <path>   Logs: <path>
- Community route: <loader vX.Y (repo)>, install: <steps>, example mod: <link>
- Chosen route for "<idea>": <route> because <reason>
- Lab plan: backup <folders> (um backup), lab profile <how>, windowed <how>
- Unknowns to resolve first: <list>

その後、mod-any-game のループ（ラボのセットアップ → 信頼できる情報源の特定 → 垂直スライス）を続けます。