拡張機能
Control Rig、Enhanced Input、GAS、Landscape/Water、Niagara、PCG に対応する任意の Unreal MCP 拡張機能。それぞれの追加内容とインストール方法を解説します。
拡張機能は Unreal MCP にさらに多くのエンジンシステムを教え込みます。それぞれが独立した任意の Unreal プラグインで、独自のバージョンとリリースを持ちます。プロジェクトで使用するものだけをインストールしてください。
すべての拡張機能は Unreal-MCP リポジトリ にあり、Unreal 拡張機能ページ に一覧が掲載されています。
拡張機能の仕組み
各拡張機能は RQL モジュールです。独自の MCP ツールを追加するのではなく、コアとなる rql-query、rql-mutate、rql-schema ツールにソース・操作・メンバーを追加し（Tools を参照）、さらに unreal-rql スキルにエージェントへ使い方を教えるセクションを追加します。エージェントのツール一覧は短いまま、その到達範囲だけが広がります。
リフレクションはすでに読み込まれたすべてのエンジン型のプロパティを公開しているため、拡張機能がなくても、たとえば Niagara コンポーネントのアセットを設定できます。拡張機能は、Niagara システムをエミッターとともに一覧表示したり、ランドスケープをスカルプトしたりといった、リフレクションでは見えない部分を追加します。
要件
- Unreal Engine 5.7 以降（拡張機能のテストスイートは 5.7 と 5.8 で検証済み）。
- 同じプロジェクト内の Unreal MCP 0.26.0 以降。
- C++ ツールチェーン。拡張機能はソースとして配布され、プロジェクトとエンジンに合わせてコンパイルされます。
- 各拡張機能が基盤とするエンジンプラグイン。インストーラーが自動で有効化します。
拡張機能同士の依存関係はありません。
6 つの拡張機能
| 拡張機能 | 拡張機能 ID | エンジンプラグイン | 追加される内容 |
|---|---|---|---|
| AI ControlRig | com.ivanmurzak.unreal-ai-control-rig | ControlRig | ボーン、コントロール、2 ボーン IK ソルバーを備えたリグを作成、Control Rig ブループリントとコンポーネントを照会 |
| AI EnhancedInput | com.ivanmurzak.unreal-ai-enhanced-input | EnhancedInput | Input Action と Mapping Context を照会し、アクションとコンテキストを作成し、キーをマップ |
| AI GAS | com.ivanmurzak.unreal-ai-gas | GameplayAbilities | アビリティ、エフェクト、アトリビュートセットのクラスと付与済みアビリティを照会し、アクターにアビリティを付与 |
| AI Landscape | com.ivanmurzak.unreal-ai-landscape | Water | ランドスケープの作成・スカルプト・ペイント、ランドスケープ・水域・ウォーターゾーンを照会 |
| AI Niagara | com.ivanmurzak.unreal-ai-niagara | Niagara | Niagara システムとそのエミッターを照会し、システムをレベルに配置 |
| AI PCG | com.ivanmurzak.unreal-ai-pcg | PCG | PCG グラフとコンポーネントを照会し、コンポーネントを追加して生成を実行 |
各拡張機能の現在のリリースは 0.2.0 です。
各 RQL モジュールの内容
| 拡張機能 | ソース | 操作 |
|---|---|---|
| AI ControlRig | controlRigs, controlRig | CreateRig, AddBone, AddControl, AddTwoBoneIK |
| AI EnhancedInput | inputActions, inputContexts, enhancedInput | CreateAction, CreateContext, AddMapping, RemoveMapping, AddActionEvent, AddMappingContextOnBeginPlay |
| AI GAS | gasAbilities, gasEffects, gasAttributeSets, gas | GrantAbility |
| AI Landscape | landscapes, waterBodies, waterZones, landscape | Create, Sculpt, Paint, CreateLayerMaterial |
| AI Niagara | niagaraSystems, niagara | SpawnSystem |
| AI PCG | pcgGraphs, pcg | AddComponent, Generate |
これらの名前を覚える必要はありません。エージェントが rql-schema とスキルから読み取ります。エージェントのクエリを読むときに役立ちます。
unreal-mcp-cli でインストール
先に Unreal Editor を閉じてから、次を実行します:
unreal-mcp-cli install-extension com.ivanmurzak.unreal-ai-niagara ./YourProjectこのコマンドは:
- 拡張機能インデックスで拡張機能 ID を検索し、最新の GitHub リリースを見つけます。
- プラグインを
<project>/Plugins/<PluginName>/に配置します（例:Plugins/UnrealAINiagara/）。 .uproject内で拡張機能とそのエンジンプラグインを有効化します。- コンパイルは次回のエディター起動時に任せるか、
--buildで即座にコンパイルします。
再実行しても安全です。同じバージョンがすでにインストールされ有効になっていれば、何も変わりません。バージョンを指定しない限り、インストール済みの拡張機能をダウングレードすることはありません。
便利なフラグ:
--version 0.2.0は指定したリリースをインストールします。--buildはその場でコンパイルします（Windows、macOS、Linux）。--source <dir>はローカルフォルダーからインストールします（オフライン環境や CI 向け）。--forceは最新であっても再インストールします。
拡張機能 ID、表示名、プラグインフォルダー名のいずれかでインストールできます。
エディターまたはアプリからインストール
- エディター内: AI Game Developer ウィンドウの Extensions セクションには、インストール済みの拡張機能が表示され、Refresh catalog の後には利用可能な拡張機能も表示されます。Install と Update で拡張機能をダウンロードします。新しい拡張機能はビルドされるまで「Installed · needs editor restart to compile」と表示されるので、Compile (Live Coding) を使用してください。
- AI Game Dev アプリ内: サイドバーの拡張機能アクション（またはアプリの CLI で
/install-extension）を使用します。アプリが最新リリースを選択します。Projects and engines を参照してください。
拡張機能の有効化と無効化
Extensions セクションの各インストール済み拡張機能には有効化トグルがあります。オフにすると、エディターを再起動せずに、その追加内容がエージェントから即座に削除されます。設定はエディターセッションをまたいで保持されます。
プロンプト例
- 「プロジェクト内のすべての Niagara システムを一覧表示し、NS_Fire のエミッターを表示して。」（AI Niagara）
- 「Boolean の Input Action IA_Jump と Mapping Context IMC_Default を作成し、スペースキーをマップして。」（AI EnhancedInput）
- 「GA_Fireball を Hero アクターに付与して。」（AI GAS）
- 「ランドスケープを作成し、その上に草のレイヤーをペイントして。」（AI Landscape）
- 「PCG_Forest を使った PCG コンポーネントを ForestVolume アクターに追加して生成して。」（AI PCG）
- 「3 ボーンのチェーンとその上に 2 ボーン IK を備えたリグを作成して。」（AI ControlRig）
独自の拡張機能を作成する
どの Unreal プラグインでも、Unreal MCP をフォークせずに独自の RQL モジュール、ツール、プロンプト、リソースを追加できます。Custom tools を参照してください。