Repolode
rehan-remade

rehan-remade/universal-modder

fal生成アセットを使い、AIコーディングエージェントによるPCゲームの調査・改造・テストを可能にするスキル、CLIツール、MCPサーバー。

スター
8,461
フォーク
934
未解決の Issue
26
最終コミット
11 時間前

これは何?

Universal Modderは、Claude Code、Codex、Cursor、Gemini CLIなどのAIコーディングエージェントに、PCゲームを改造するためのワークフローを提供します。エージェントはゲームのインストール先、エンジン、バージョンを特定し、改造方法を選び、ゲームのコードを読み、動作するmodを作成して、実際に起動したゲーム内で確認します。同梱の`um` CLIは、インストール先のスキャン、falを使ったスプライト・3Dモデル・音声の生成、ウィンドウと音声のキャプチャ、紹介動画の編集を行います。

対応するエンジンやゲームは幅広く、Unity、Unreal、.NET/XNA、Godot、Minecraft、Age of Empires II、Bethesda作品などが含まれます。また、ILSpy、Ghidra、Fridaなどのリバースエンジニアリングツールも利用できます。スキルでは、既存のメモを検索し、調査を実行し、セーブデータをバックアップし、一部分ずつ作成して、アセットを生成・検証し、知見を記録するという決まった手順をたどります。エージェントは、リポジトリ内の共有ナレッジベースに現場で得たメモを追加することもできます。

このプロジェクトは、アンチチート機能のあるオンラインゲームへのインジェクションや、他のプレイヤーに対する不正行為を拒否し、ゲームファイルや逆コンパイルしたコードを配布することもありません。セットアップにはGit、Python 3.10以降、ffmpegが必要で、アセット生成にはfal APIキーも必要です。

主な機能

  • 01Steam、Epic、Xboxのインストール先をスキャンし、エンジン、バージョン、アンチチートを特定します。
  • 02リバースエンジニアリング、調査、アセット生成、ゲーム内テスト用のエージェントスキルを提供します。
  • 03falを使ってスプライト、3Dモデル、テクスチャ、音声を生成します。
  • 04ゲームウィンドウとゲーム音声のみをキャプチャでき、入力先もゲームウィンドウのみに限定できます。
  • 05変更前にセーブデータのフォルダーをバックアップし、ゲームファイルの公開をブロックする公開チェック機能を備えています。

ユースケース

  • AI生成スプライトを使って、Terrariaのmodに新しい武器や敵を追加する。
  • Age of Empires II DE向けに、新しい文明やユニットを作成する。
  • 完成したゲームmodの紹介動画を録画・編集する。
  • あるゲームが過去にmod化されたことがあるか、どのエンジンを使用しているかを調べる。

クイックスタート

  1. 1

    uvでum CLIをインストールする

    uv tool install git+https://github.com/rehan-remade/universal-modder
  2. 2

    fal APIキーを保存する(任意、アセット生成用)

    um fal key set
  3. 3

    AIコーディングエージェントにスキルをインストールする

    npx skills add https://github.com/rehan-remade/universal-modder

使う前に知っておきたいこと

  • Modの対象は所有しているPCゲームのみです。また、READMEでは他のプレイヤーへのチートを避けるようエージェントに求めています。
  • アセット生成には、有料のfal APIキー、スプライト用のSprixenキー、またはローカルのComfyUIサーバーが必要です。
  • 3DからスプライトへのレンダリングにはBlenderが必要です。Windowsゲームはネイティブ環境またはWSLから操作します。

トピック

よくある質問

universal-modder とは?
fal生成アセットを使い、AIコーディングエージェントによるPCゲームの調査・改造・テストを可能にするスキル、CLIツール、MCPサーバー。 Universal Modderは、Claude Code、Codex、Cursor、Gemini CLIなどのAIコーディングエージェントに、PCゲームを改造するためのワークフローを提供します。エージェントはゲームのインストール先、エンジン、バージョンを特定し、改造方法を選び、ゲームのコードを読み、動作するmodを作成して、実際に起動したゲーム内で確認します。同梱の`um` CLIは、インストール先のスキャン、falを使ったスプライト・3Dモデル・音声の生成、ウィンドウと音声のキャプチャ、紹介動画の編集を行います。
universal-modder は無料で使えますか?ライセンスは?
universal-modder は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
universal-modder は今もメンテナンスされていますか?
活発にメンテナンス中。universal-modder の最終コミットは 2026年10月19日 です。
universal-modder は何に使えますか?
AI生成スプライトを使って、Terrariaのmodに新しい武器や敵を追加する。 Age of Empires II DE向けに、新しい文明やユニットを作成する。 完成したゲームmodの紹介動画を録画・編集する。 あるゲームが過去にmod化されたことがあるか、どのエンジンを使用しているかを調べる。
universal-modder のインストール方法は?
uvでum CLIをインストールする: uv tool install git+https://github.com/rehan-remade/universal-modder fal APIキーを保存する(任意、アセット生成用): um fal key set AIコーディングエージェントにスキルをインストールする: npx skills add https://github.com/rehan-remade/universal-modder
universal-modder はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/rehan-remade/universal-modder

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト