プロジェクトとエンジン

AI Game Dev アプリで行うことはすべて、プロジェクト（コンピューター上のフォルダー）の中で完結します。そのフォルダーが Unity、Unreal Engine、Godot のプロジェクトであれば、アプリがエンジンを検出し、対応する MCP プラグインをセットアップして、エディターのツールをチャットに接続します。このページでは、デスクトップアプリと CLI でのプロジェクトのオープンと作成、プラグインのインストールと更新、そしてエージェントがエディターと連携する仕組みについて説明します。

対応エンジン#

Blender 専用のアセットプロジェクト、設計ドキュメントのフォルダー、ツールのリポジトリなど、その他のフォルダーを開くこともできます。その場合エージェントはエンジンのツールこそ使えませんが、ファイルやパッケージ、ツールを扱えます。

デスクトップアプリでプロジェクトを開く#

空のウィンドウはランチャーです。次の項目が表示されます。

• Open folder… でプロジェクトのフォルダーを選択します。
• Create new project で新しい Unity、Unreal、Godot プロジェクトを開始します。
• 最近使ったプロジェクトの一覧。

各プロジェクトはそれぞれのウィンドウで開きます。最近使ったプロジェクトを Ctrl キーを押しながらクリック（Windows、Linux）または Cmd キーを押しながらクリック（macOS）すると、現在のウィンドウを置き換えずに新しいウィンドウで開きます。アプリを再起動すると、開いていたプロジェクトのウィンドウがサイズ、位置、レイアウトとともに復元されます。

エンジンプラグインのインストールまたは更新#

エンジンのプロジェクトを開くと、サイドバーにそのプロジェクトのエンジンと操作項目が表示されます。

• エンジンプラグインがまだプロジェクトにない場合は Install Package、新しいバージョンのプラグインが利用可能な場合は Update Package が表示されます。
• Open Editor でこのプロジェクトのエンジンエディターを起動します。

Install Package をクリックするとプラグインが追加されます。アプリが既存のプロジェクトを勝手に変更することはありません。インストールはプロジェクトに書き込む操作（たとえば Unity では Packages/manifest.json にパッケージを追加します）なので、クリックがあなたの同意となるのです。アプリからプロジェクトを作成した場合は、作成の一環としてプラグインが自動的にインストールされます。

プラグインのインストーラーはアプリに同梱されています。お使いのマシンに Node.js、npm、unity-mcp-cli、unreal-mcp-cli、godot-cli は必要ありません。

CLI では同じ操作をスラッシュコマンドで行います。

/install-plugin            install the MCP plugin into the current project
/install-plugin C:/Games/MyGame
/open                      open the editor for the current project

エンジン拡張機能#

エンジン拡張機能を使うと、プラグインにツールを追加できます。たとえば Unity 向けのパーティクルシステムやアニメーション用の追加ツールなどです。デスクトップアプリではサイドバーの拡張機能アクションから、CLI では /install-extension で参照・インストールできます。各エンジンで利用できる拡張機能は拡張機能ページに一覧があります。

新しいプロジェクトの作成#

デスクトップアプリでは Create new project を選択します。

1. エンジンを選びます。
2. プロジェクト名を入力します。プロジェクトは、選択した親フォルダー内にその名前のサブフォルダーとして作成されます。存在しないフォルダーは作成されます。
3. エディターを選びます。インストール済みの最新バージョンが事前に選択されているほか、インストール済みのエディターを手動で選ぶこともできます。そのエンジンのエディターがインストールされていない場合はその旨が表示されるので、先にエンジンをインストールしてから続行してください。
4. アプリがプロジェクトを作成し、プラグインをインストールして開きます。

CLI の場合:

/create-project unity SkywardKeep
/create-project godot SkywardKeep D:/Games

構文は /create-project <unity|godot|unreal> <name> [parentDir] です。

エージェントがエディターと連携する仕組み#

エディターが起動していなくてもチャットは開始できます。通常の会話で何かが起動されることはありません。エージェントがタスクのためにエディターを必要とすると、アプリにプロジェクトのエディターを開くよう要求し、エディターのツールが利用可能になるまで待ってから、同じタスクを続行します。セッションの途中で（たとえばあなた自身が開いたことで）後からオンラインになったエディターは、新しいチャットを開始することなく、実行中のチャットに接続されます。

いくつかのルールにより、この動作は予測可能になっています。

• 複数のセッションが同時に必要としても、プロジェクトごとに起動されるエディターは 1 つだけです。
• すでに送信されたエンジン呼び出しが、切断後に自動で再実行されることはありません。エージェントは別の書き込みを試す前に結果を確認します。
• Stop はエディターの待機をキャンセルします。すでに起動したエディターは開いたままです。
• 大きなプロジェクトの起動には時間がかかることがあります。起動には最大 15 分、その後ツールが現れるまで最大 2 分が与えられます。

エディター内での操作#

各プラグインはエディター内に専用のウィンドウ（Unity では AI Game Developer ウィンドウ）を持ち、接続状態を表示します。アプリがエディターを開く際にはサインイン済みのセッションが渡されるため、プラグインは手動でトークンを入力することなく ai-game.dev 経由で接続します。エディターに「Disconnected」と表示される場合は、そのウィンドウを開いて Cloud を選択し、Authorize をクリックしてから Ready になるまで待ってください。

プラグイン固有の設定、手動インストール、他の AI クライアントの接続については、各エンジンの wiki で説明しています。

• Unity: インストール、AI クライアントの接続、unity-mcp-cli。
• Unreal: インストール、AI クライアントの接続、unreal-mcp-cli。
• Godot: インストール、AI クライアントの接続、godot-cli。

CLI でプロジェクトを開く#

CLI は現在のディレクトリ、または指定したフォルダーで動作します。

cd /path/to/your/game
gamedev

# or
gamedev /path/to/your/game
gamedev --project /path/to/your/game

起動時に、CLI は検出結果（たとえば「Unity project detected」）や、そのフォルダーに Unity、Godot、Unreal のプロジェクトがない旨を表示します。

エージェントがプロジェクト内でできること#

エンジンが接続されていれば、次のように自然言語で依頼できます。

• 「アクティブなシーンにあるものをすべて一覧にして。」
• 「原点に立方体を作成し、物理ボディを付けて。」
• 「現在のビューのスクリーンショットを撮って。」

ツールカタログにはすべてのエンジンツールが一覧されており、ベストプラクティスではうまくいく依頼の書き方を説明しています。Unity、Unreal、Godot のエンジンページでは、各連携の概要をまとめています。