rehan-remade/universal-modder

universal-modder – AI駆動型ゲームMODツールキット

何であるか

• 大規模言語モデルによるコーディングエージェント（Claude、Codex、Gemini、Copilot、Cursorなど）が、所有するほぼすべてのPCゲームに対して自動的にMODを作成・テスト・公開できるようにする、エージェントスキルのコレクションと小さなPython CLI（um）。
• リポジトリは、特定のゲームがどのように逆コンパイルされたか、使用しているエンジン、成功した正確な手順などを記録する知識ベース（knowledge/）を提供します。新しいエージェントは作業を開始する前にこのベースを検索できます。

動作方法

1. エージェントプラグイン – お好みのLLMコーディングアシスタントにこのリポジトリをプラグインとしてインストール（Installの下の表を参照）。プラグインにより、skills/内のスキルと、各エージェントが読み取る設定ファイル（AGENTS.md）が追加されます。
2. mod-any-gameスキル – これはメインループです。以下を実行します：
   • 対象ゲームに関する過去の作業を知識ベースで検索。
   • 調査（エンジン検出、バージョン、アンチチート状態、セーブファイルの場所）。
   • 安全な実験環境（セーブファイルのバックアップ、プロセスの分離）をセットアップ。
   • ゲームコードを読み取り（ILSpy、Ghidraなどで逆コンパイル）。
   • 最小限の動作するMODスライスを生成。
   • um falサブコマンド経由でfal.aiを呼び出し、スプライト、テクスチャ、3Dモデル、音声、音楽、ボイスを生成。
   • 自動化ツール（um win：起動、スクリーンショット、入力制御）でゲーム内でMODを検証。
   • モニタリング動画を記録（um video）。
   • MODをパッケージ化し、将来のエージェント用に新しいフィールドノートを記録。
3. CLI（um） – 各段階に対応する具体的なコマンドを提供：インストール済みゲームのスキャン、アセット生成、3Dからスプライトへのレンダリング、Windows自動化、バックアップ/復元、知識ベースのCRUD、パブリッシュチェック。
4. セキュリティルール – オンラインマルチプレイヤー対応ゲームには手を出さず、逆コンパイルされたゲームファイルを送信せず、セーブファイルをバックアップし、侵襲的な操作の前にユーザーの確認を求める。

主なコンポーネント

• スキルディレクトリ – Unity、Unreal、.NET/XNA、Godot、Source、Bethesda、Minecraft、AoE2、RE Engine、ネイティブC++、多数のインディーエンジンを含む12のエンジン「プレイブック」用に事前に書かれたプロンプトとスクリプト。各プレイブックは、そのエンジンにおける典型的な逆コンパイルとMOD構築ワークフローをエンコードしています。
• 知識ベース – Markdown形式のフィールドノート（knowledge/games/<game>/<mod>.md）で、バージョン、経路、検証手順、落とし穴を記録。エージェントは um kb search "grand theft auto" と検索でき、後で um kb pr … で新しいノートを提出できます。
• Fal統合 – アセット生成はFal AIサービス（画像から3D生成、テクスチャのアップスケーリング、音声合成など）に委ねられます。CLIはREST APIをラップ（um fal …）します。
• 自動化ユーティリティ – 安全なマウス/キーボードインジェクションとループバックオーディオキャプチャ用のPowerShellツール、ゲーム起動、スクリーンショット撮影、動画記録用のPythonラッパー。

リポジトリ内の例

• Terraria – Falで生成されたすべてのスプライトを含む、ホーミングミサイルランチャーと戦術核の追加。
• Age of Empires II DE – 3Dモデルからレンダリングされたロボットタクシー単位を含む新しい文明の作成。
• Minecraft × GTA Vマッシュアップ – MinecraftのレンダリングフレームをGTA Vにストリーミングし、WebSocketブリッジでカメラと物理を同期。

対象ユーザー

• AI支援MODパイプラインを開発する開発者。
• 自動化された逆コンパイルとアセット生成を研究する研究者。
• シングルプレイヤーゲームMODに再現可能でAI駆動のワークフローを求めるアマチュア。

インストールのクイックスタート

# CLIのインストール（Python 3.10+必須、uv推奨）
uv tool install git+https://github.com/rehan-remade/universal-modder
# またはpipxで
pipx install git+https://github.com/rehan-remade/universal-modder

# アセット生成用にFal APIキーをエクスポート
export FAL_KEY=your_key_here

その後、お好みのLLMコーディングエージェント（Claude、Codex、Gemini、Copilot、Cursorなど）にリポジトリをプラグインとして追加し、um scanを実行してゲームを検出します。

ライセンス – MIT（フォントはSIL OFL下）