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

Unity MCPの拡張機能は、Animation、Cinemachine、Input System、Navigation、ProBuilder、Splines、Terrain、Tilemap、Timeline、パーティクルに対するAIサポートを追加します。

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

拡張機能は、Cinemachineのカメラ、ProBuilderのメッシュ、2Dタイルマップなど、特定のUnity機能をAIエージェントに教えるためのオプションのUnityパッケージです。プロジェクトで使うものだけをインストールしてください。このページでは、10個の公式拡張機能、それぞれが追加する内容、そしてインストール方法を説明します。各拡張機能には、[Unity extensions catalog](https://ai-game.dev/docs/extensions/unity)内の詳細ページもあります。

## 拡張機能の仕組み

Unity MCP 1.0.0（および拡張機能バージョン2.0.0）以降、拡張機能は**新しいMCPツールを追加しません**。代わりに**RQLモジュール**を提供します。これは既存の`rql-query`および`rql-mutate`ツールが理解できる新しいソース、関数、型アダプターです。エージェントのツールリストのサイズは変わらず、拡張機能のガイドは生成される`unity-rql`スキルに追加されるため、パッケージをインストールしてスキルを再生成すれば、エージェントはすぐに新しい構文を学習します。

たとえば、AI Tilemapをインストールすると、エージェントはRQL経由でタイルを描画できます。

```text
objects | get components | where $ is Tilemap | call BoxFill("Assets/Tiles/Grass.asset", -5, -3, 5, 3)
```

各拡張機能はコアプラグイン`com.ivanmurzak.unity.mcp`と、その土台となるUnityパッケージに依存しています。インストールすると両方が取り込まれます。すべてUnity 2022.3以降をサポートしています。

## 公式拡張機能

| 拡張機能 | パッケージID | 基盤となるパッケージ | RQLの追加内容 |
| --- | --- | --- | --- |
| AI Animation | `com.ivanmurzak.unity.mcp.animation` | Animationモジュール | `animation`ソース、AnimationClip、AnimatorController、Animator型 |
| AI Cinemachine | `com.ivanmurzak.unity.mcp.cinemachine` | `com.unity.cinemachine` | `cinemachine`ソース、CinemachineCamera、CinemachineBrain |
| AI InputSystem | `com.ivanmurzak.unity.mcp.inputsystem` | `com.unity.inputsystem` | `input`ソース、InputActionAsset |
| AI Navigation | `com.ivanmurzak.unity.mcp.navigation` | `com.unity.ai.navigation` | `navigation`ソース、NavMeshSurface、NavMeshLink、NavMeshAgent |
| AI Particle System | `com.ivanmurzak.unity.mcp.particlesystem` | Particle Systemモジュール | ParticleSystemとそのモジュール、カーブ、グラデーション |
| AI ProBuilder | `com.ivanmurzak.unity.mcp.probuilder` | `com.unity.probuilder` | `probuilder`ソースと関数、ProBuilderMesh |
| AI Splines | `com.ivanmurzak.unity.mcp.splines` | `com.unity.splines` | `splines`ソース、SplineContainer |
| AI Terrain | `com.ivanmurzak.unity.mcp.terrain` | Terrainモジュール | `terrain`ソース、高さ関数、Terrain、TerrainData |
| AI Tilemap | `com.ivanmurzak.unity.mcp.tilemap` | Tilemapモジュールと2D Tilemap Extras | `tilemap`ソースと関数、Tilemap、RuleTile |
| AI Timeline | `com.ivanmurzak.unity.mcp.timeline` | `com.unity.timeline` | `timeline`ソース、TimelineAsset、トラック、クリップ、PlayableDirector |

各モジュールの正確なソース、関数、呼び出しは、それぞれの[カタログページ](https://ai-game.dev/docs/extensions/unity)およびエディター内の`rql-schema`にあります。

## AI Game Developerウィンドウからインストールする

1. **Window > AI Game Developer — MCP**を開きます。
2. **Extensions**までスクロールします。
3. 目的の拡張機能の横にある**Install**をクリックします。

このウィンドウは、OpenUPMのスコープ付きレジストリとパッケージを、OpenUPM上の最新バージョンで`Packages/manifest.json`に追加します。その後、Unityが解決してインポートします。

## unity-mcp-cliでインストールする

```bash
unity-mcp-cli install-extension --list
unity-mcp-cli install-extension Tilemap ./MyUnityProject
```

idにはカタログ名（`Tilemap`、`Cinemachine`、`ProBuilder`など）またはパッケージID（`com.ivanmurzak.unity.mcp.tilemap`）を指定でき、大文字と小文字は区別されません。パスはデフォルトでカレントフォルダーになります。このコマンドは最新のOpenUPMバージョンを解決し、インストール済みのより新しいバージョンをダウングレードすることはなく、拡張機能がすでに最新の場合は何も行いません。バージョンを固定するには`--extension-version <version>`を使います（CLIのバージョンを表示する`--version`ではありません）。その後、Package Managerが解決できるようにUnityを開くかフォーカスしてください。

## OpenUPMでインストールする

```bash
openupm add com.ivanmurzak.unity.mcp.cinemachine
```

[Unity-MCPリポジトリ](https://github.com/IvanMurzak/Unity-MCP/tree/main/extensions)にある各拡張機能のREADMEには、その拡張機能用の`.unitypackage`インストーラーへのリンクもあり、[コアインストーラー](https://ai-game.dev/ja/docs/wiki/unity/installation#installer)と同じように動作します。

## デスクトップアプリでインストールする

[AI Game Devアプリ](https://ai-game.dev/docs/app)でも、開いているプロジェクトにUnity拡張機能をインストールできます。コアプラグインのバージョンとは独立した、各拡張機能自身のOpenUPMバージョンを使用します。詳しくは[アプリのドキュメント](https://ai-game.dev/ja/docs/wiki/app)を参照してください。

## インストール後

- スキルを再生成します（ウィンドウの**Skills > Generate**、または`unity-mcp-cli setup-skills <agent>`）。これにより、エージェントの`unity-rql`スキルに新しいモジュールが含まれます。
- エージェントが新しい型を認識していないようであれば、`rql-schema`から始めるよう依頼してください。たとえば「rql-schemaを使ってcinemachineソースが何を提供しているか確認し、Player用のフォローカメラを追加して」のように伝えます。
- `tilemap-set-tile`や`cinemachine-camera-create`など、古いチュートリアルのツール名はもう存在しません。各拡張機能のREADMEに、それらに対応するRQLの書き方が示されています。

## 更新と削除

拡張機能はコアプラグインとは別にバージョン管理されています。更新はPackage Managerで行うか、`install-extension`を再実行します。削除は他のパッケージと同じくPackage Managerから行います。コアプラグインと拡張機能は、対応する現行バージョンをそろえて使ってください。拡張機能は必要とするコアの最低バージョンを宣言しています。

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

プロジェクトのコードから直接ツールを追加することも（[カスタムツール](https://ai-game.dev/ja/docs/wiki/unity/custom-tools)を参照）、[カスタムRQLアダプター](https://ai-game.dev/docs/rql/custom-adapters)で独自の型をRQLに教えることもできます。リポジトリの[拡張機能ガイド](https://github.com/IvanMurzak/Unity-MCP/blob/main/docs/dev/extensions.md)では、公式拡張機能の構築方法とテスト方法を説明しています。

## 関連ページ

- [Unity extensions catalog](https://ai-game.dev/docs/extensions/unity)と[すべての拡張機能](https://ai-game.dev/docs/extensions)。
- [ツールとRQL](https://ai-game.dev/ja/docs/wiki/unity/tools-and-rql)。

---

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

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