# 拡張機能 — Godot · AI Game Developer Wiki

AnimationPlayer、CSG、GridMap、ナビゲーション、パーティクル、TileMapLayer、Beehave、Dialogic、Phantom Camera、Terrain3D 向けのオプションの Godot MCP 拡張機能をインストールできます。

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

拡張機能は、Godot MCP に Godot のより多くの領域と、人気のある Godot アドオンに関する知識を与えるオプションの NuGet パッケージです。プロジェクトに必要なものだけをインストールしてください。このページでは、拡張機能の一覧、仕組み、そしてインストール方法 3 通りを説明します。各拡張機能の説明と例は、サイトの [Godot 拡張機能](https://ai-game.dev/docs/extensions/godot) ページにあります。

## 拡張機能の仕組み

各拡張機能は RQL モジュールです。独自の MCP ツールは追加しません。その代わりに、コアの `rql-query`、`rql-mutate`、`rql-schema` ツールを新しいソース、検証済みのプロパティと呼び出しで拡張し、エージェントの `godot-rql` スキルにガイドを追加します。エージェントのツールリストのサイズは変わらず、エージェントは `rql-schema` を通して新しい領域を学びます:

```text
rql-schema "Particles"
```

パッケージには C# ソースとビルド設定が含まれ、プロジェクト自身の GodotSharp に対してコンパイルされます。各拡張機能には独自のバージョンとリリースがあります。

## 利用可能な拡張機能

| 拡張機能 | パッケージ ID | 追加される内容 | 必要条件 |
| --- | --- | --- | --- |
| Animation Tools | `com.IvanMurzak.Godot.MCP.Animation` | AnimationPlayer のライブラリ、アニメーション、トラック、キー | Godot 4.3+ |
| Beehave Tools | `com.IvanMurzak.Godot.MCP.Beehave` | ビヘイビアツリーとそのノードの一覧表示 | Beehave アドオン、Godot 4.3+ |
| CSG Tools | `com.IvanMurzak.Godot.MCP.CSG` | 検証済みの CSG プリミティブの寸法と `rootShape` | Godot 4.3+ |
| Dialogic Tools | `com.IvanMurzak.Godot.MCP.Dialogic` | タイムラインとキャラクターの一覧表示・作成、タイムラインへのテキスト追加 | Dialogic アドオン、Godot 4.4+ |
| GridMap Tools | `com.IvanMurzak.Godot.MCP.GridMap` | GridMap の設定、セル行、セル編集 | Godot 4.3+ |
| Navigation Tools | `com.IvanMurzak.Godot.MCP.Navigation` | 2D および 3D のナビゲーションエージェント、リージョン、リンク、リージョンベイク | Godot 4.3+ |
| Particles Tools | `com.IvanMurzak.Godot.MCP.Particles` | 2D および 3D の GPU パーティクル: 検証済みのエミッター設定と再起動 | Godot 4.3+ |
| PhantomCamera Tools | `com.IvanMurzak.Godot.MCP.PhantomCamera` | 仮想カメラとホストの一覧表示、follow および look-at ターゲットの設定 | Phantom Camera アドオン、Godot 4.4+ |
| Terrain3D Tools | `com.IvanMurzak.Godot.MCP.Terrain3D` | Terrain ソース、リージョンサイズの変更、マテリアルの作成 | Terrain3D アドオン、Godot 4.4+ |
| Tilemap Tools | `com.IvanMurzak.Godot.MCP.Tilemap` | TileMapLayer の使用済みセル行とセル編集 | Godot 4.3+ |

どの拡張機能にも、RQL ツールを含むコアアドオン（0.28.0 以降の任意のリリース）が必要です。

**メモ**

インストーラーが追加するのは拡張機能パッケージだけです。Beehave、Dialogic、Phantom Camera、Terrain3D については、先にそのサードパーティ製アドオンをご自身でプロジェクトにインストールしてください。

## godot-cli でインストール

```bash
godot-cli install-extension com.IvanMurzak.Godot.MCP.CSG ./MyGodotProject
godot-cli build ./MyGodotProject
```

`install-extension` は、拡張機能カタログから ID を検索します。まずパッケージ ID で、次に名前で、大文字と小文字を区別せずに検索します（そのため `"CSG Tools"` も使えます）。そしてプロジェクトの `.csproj` 内の `<PackageReference>` を追加または更新します:

- まだ参照されていない: 参照が追加されます。
- 古いバージョンが参照されている: 更新されます。
- すでに最新: 何も変わりません。

`--version` を指定しない場合、参照は NuGet の最新安定版リリースを指します（`Version="*"`）。正確なバージョンを指定するには `--version <x.y.z>` を使います。インストール後は、Godot がパッケージを復元してコンパイルできるようプロジェクトをビルドしてください。Godot には自動の復元ステップがありません。

## ドックからインストール

AI Game Developer ドックの **Extensions** セクションには、同じカタログが **Install** と **Update** ボタン付きで表示されます。`.csproj` を CLI と同じ方法で編集します。その後で再ビルドしてください。ドックに `.csproj` が見つからないと表示される場合、アドオンが Godot の C# プロジェクト内にありません。

## AI Game Dev アプリからインストール

Godot プロジェクトの場合、[AI Game Dev アプリ](https://ai-game.dev/ja/docs/wiki/app) のサイドバーに **Extensions** ボタンが表示され、これが同じカタログを開き、`godot-cli` と同じコードでインストールします。スラッシュコマンド `/install-extension` を使えば、アプリのチャットから同じことができます。引数なしならカタログを一覧表示し、ID を指定すれば現在のプロジェクトにインストールします。エンジンの拡張機能は、アプリ自体のパッケージとは異なります。

## 拡張機能カタログ

拡張機能の一覧は、アドオンに同梱される `addons/godot_mcp/extensions.catalog.json` にあります。ドック、`godot-cli`、アプリはいずれもこの 1 つのファイルを読み込みます。ドックはコンパイル済みのプロジェクトから読み込むため、`.csproj` がこのファイルを埋め込む必要があります:

```xml
<ItemGroup>
  <EmbeddedResource Include="addons/godot_mcp/extensions.catalog.json" LogicalName="Godot-MCP.extensions.catalog.json" />
</ItemGroup>
```

`godot-cli install-plugin` とアプリはこの行を自動で追加します。手動でインストールした場合に Extensions 一覧が空なら、この行が欠けています。追加して再ビルドしてください。詳しくは [インストール](https://ai-game.dev/ja/docs/wiki/godot/installation#nuget-packages) を参照してください。

## 拡張機能を使う

ビルド後は、あとは頼むだけです。たとえば、CSG Tools をインストールした状態では次のようになります:

- "3x3x3のボックスを作成し、そこから半径1.8の球を減算するCSGコンバイナーを構築してください。"
- "シーン内のすべてのCSGシェイプを、その操作とサイズとともに一覧表示してください。"

エージェントは`rql-mutate`でノードを作成し（呼び出しごとに1つの undo 可能なステップ）、`rql-query`で結果を確認します。負の半径など無効な値が指定された場合、変更全体が失敗し、シーンは変更されません。

## 独自の拡張機能を作成する

Godot-MCPリポジトリには拡張テンプレート（`templates/extension/`）と、モジュールのビルド・テスト・リリースのためのモノレポガイドが含まれています。単発のプロジェクト用ツールであれば、[カスタムツール](https://ai-game.dev/ja/docs/wiki/godot/custom-tools)をそのまま使うほうが簡単です。

---

Source (HTML): https://ai-game.dev/ja/docs/wiki/godot/extensions

Machine-translated (ja) from the English page: https://ai-game.dev/docs/wiki/godot/extensions