# プロジェクトとエンジン — AI Game DevアプリとCLI · AI Game Developer Wiki

AI Game Dev アプリで Unity、Unreal、Godot プロジェクトを開くか新規作成し、エンジンプラグインをインストールすると、必要に応じてエージェントがエディターを開きます。

このページは英語から機械翻訳されています。[英語の原文を読む](https://ai-game.dev/docs/wiki/app/projects-and-engines)。

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

## 対応エンジン

| エンジン | プラグイン | プロジェクトの認識方法 | 対応バージョン |
| --- | --- | --- | --- |
| Unity | [Unity MCP](https://ai-game.dev/ja/docs/wiki/unity) | `ProjectSettings/ProjectVersion.txt`、または `Assets/` フォルダーと `Packages/manifest.json` の組み合わせ | Unity 2022.3 LTS 以降 |
| Unreal Engine | [Unreal MCP](https://ai-game.dev/ja/docs/wiki/unreal) | フォルダー内の `*.uproject` ファイル | Unreal Engine 5.5 以降、C++ プロジェクト |
| Godot | [Godot MCP](https://ai-game.dev/ja/docs/wiki/godot) | フォルダー内の `project.godot` ファイル | Godot 4.3〜4.5（.NET） |

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 では同じ操作をスラッシュコマンドで行います。

```text
/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` で参照・インストールできます。各エンジンで利用できる拡張機能は[拡張機能ページ](https://ai-game.dev/docs/extensions)に一覧があります。

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

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

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

CLI の場合:

```text
/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: [インストール](https://ai-game.dev/ja/docs/wiki/unity/installation)、[AI クライアントの接続](https://ai-game.dev/ja/docs/wiki/unity/connecting-ai-clients)、[`unity-mcp-cli`](https://ai-game.dev/ja/docs/wiki/unity/cli)。
- Unreal: [インストール](https://ai-game.dev/ja/docs/wiki/unreal/installation)、[AI クライアントの接続](https://ai-game.dev/ja/docs/wiki/unreal/connecting-ai-clients)、[`unreal-mcp-cli`](https://ai-game.dev/ja/docs/wiki/unreal/cli)。
- Godot: [インストール](https://ai-game.dev/ja/docs/wiki/godot/installation)、[AI クライアントの接続](https://ai-game.dev/ja/docs/wiki/godot/connecting-ai-clients)、[`godot-cli`](https://ai-game.dev/ja/docs/wiki/godot/cli)。

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

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

```bash
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 のプロジェクトがない旨を表示します。

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

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

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

[ツールカタログ](https://ai-game.dev/docs/tools)にはすべてのエンジンツールが一覧されており、[ベストプラクティス](https://ai-game.dev/docs/best-practices)ではうまくいく依頼の書き方を説明しています。[Unity](https://ai-game.dev/ja/engines/unity)、[Unreal](https://ai-game.dev/ja/engines/unreal)、[Godot](https://ai-game.dev/ja/engines/godot) のエンジンページでは、各連携の概要をまとめています。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/app/projects-and-engines

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/app/projects-and-engines