シリーズ: Unity 初心者が Cursor の AI エージェントと3DアクションRPGを作る

第0回: ゲームプログラムが書けない私が、生成AIでゲームを作り始めた ― Phaser で2Dを1本、次は Unity × Cursor で3Dへ https://qiita.com/yasuharusmooth/items/8e8bd09d7f111fffbe40
第0.5回: 作りたい3DアクションRPGを、AIで作ったイメージボード3枚で紹介します ― いまできていること／これから作ること https://qiita.com/yasuharusmooth/items/aa0a8e2de2dae070e180
第1回: Unity 初めてで、AI に使い方を教わったのは最初の2回だけ。あとはエディタ作業ごと任せた話 https://qiita.com/yasuharusmooth/items/f2058b38d412b03d8c80
第2回: インスペクターの参照設定を人がやる意味はなかった ― Cursor × Unity MCP でエディタ設定まで AI に任せる（この記事）
第3回: AI エージェントを増やしたら数字の確認ばかりに ― 「判断だけ聞いて、数字は仮で入れて」にした話 https://qiita.com/yasuharusmooth/private/8ba5ce8473f161502950
番外編: ゲームのプログラムが書けなくても、主人公の3Dモデルは用意できた：Gemini → Meshy → Mixamo → Unity の流れ https://qiita.com/yasuharusmooth/private/35806e8a2ec0c0c94093

Cursor が C# で実装したものを、インスペクター上で指定する作業。これは人でやる意味が無いと思ったので、エージェントに任せました。今回は、その「エディタ上の設定作業」の話です。

この記事で分かること

Unity MCP を使って、Inspector の参照設定までエージェントに任せたときの様子
エージェントにエディタを触らせるときに、ルールに書いておいたこと
実際に任せた設定作業の例

結論（3行）

Cursor が書いたスクリプトの参照をインスペクターで指定する作業は、人がやる意味が無いと感じて、エージェントに任せました。
最初から Unity MCP で Cursor と Unity エディタをつなぐ前提でやっていて、配置・設定・保存はエージェントが起動中のエディタ経由で行います。
ルールには「シーンや Prefab のファイルを手で書き換えない」「コンパイル後はエラーを確認する」と書き、人は Play で触って判断します。

Unity MCP とは

MCP（Model Context Protocol）は、AI のツールと外部のアプリをつなぐための共通の仕組みです。Unity MCP は、これを使って Cursor などの AI と起動中の Unity エディタをつなぐものです。

正直に言うと、私は最初から MCP ありきでやっていたので、MCP なしの場合と比べたわけではありません。それでも、コードを書くだけでなく、エディター上の設定（インスペクターでの参照指定など）までエージェントに任せられたのは、MCP でエディターとつないでいたからだと思っています。

この画面の設定を、自分でやらなくてよかった

![Body Motion Set の Inspector。右列のクリップ参照名はぼかしています](【画像URL: 2026-10-08_inspector-bodymotionset_blur.png】)

これは Body Motion Set というデータの Inspector（選んだ物の設定画面）です。待機・移動・ジャンプ・攻撃などの動作ごとに、どのアニメーションクリップを再生するか（右列の参照）と、再生時間などの数値を持っています。ScriptableObject（設定値を Unity のファイルとして持つ仕組み）で、C# は programmer（実装担当のエージェント）が書いています。

人がやるなら、Project（素材の一覧）から右列の枠へ、クリップを1つずつドラッグすることになります。

この割り当ては、エージェントが起動中の Unity 経由で更新・保存した記録が ADR（設計の判断を1件ずつ残すメモ）に残っています。ADR-0047 では待機のクリップを替えて保存し、ADR-0067 ではクリップ6本を差し替えて、ループ再生の設定（Loop Time）もオンにしています。

このインスペクターの設定作業をやらなくて良いのは、結構良いことだと感じていました。

ルールに書いたこと

エディタを触らせるにあたって、常に読み込ませるルールに分担を書いています。

.cursor/rules/00-core-unity.mdc（抜粋）

- C# の作成と修正は programmer が行う。ユーザーにスクリプト本文の手書きを求めない。
- ユーザーが採用した仕様の Hierarchy、Inspector の値、Prefab、Tag、Layer、参照割当、ScriptableObject アセットは programmer が、起動中の Unity エディタ経由で作る。シーンと Prefab の YAML は手で書き換えない（ADR-0004）。

シーンや Prefab（使い回せる部品）の中身は YAML というテキスト形式ですが、それを直接書き換えず、エディタ経由で作らせます。programmer のルールには、作業後の確認と報告の形も書きました（思考の5番と出力の4番）。

.cursor/rules/role-programmer.mdc（抜粋）

5. コンパイル後は Unity MCP の `read_console` でエラーを確認する。
（中略）
4. 起動中の Unity へ入れた配置（オブジェクト、コンポーネント、Inspector の値、参照）。シーンと Prefab の YAML は手で書き換えない

read_console は Unity のコンソール（エラーや警告の一覧）を読む機能です。1つの依頼の流れはこうなります。

任せた設定作業の例

ADR に残っている中から、エディタ上の作業をいくつか挙げます。

ADR	日付	内容
ADR-0047	10-06	待機モーションの割り当てを替えて保存
ADR-0058	10-06	キャラ定義のデータを、シーンのキャラと Prefab に割り当て
ADR-0062	10-07	敵の頭上に体力の表示を追加し、敵の Prefab にも入れる
ADR-0067	10-07	モーション6本の割り当てを差し替え、Loop Time をオン
ADR-0085	10-08	店の画面で、各アイテムにアイコンを設定して保存

どれも「仕様は決まっていて、あとはエディタで指定するだけ」の作業です。

人がやること

任せたあとに私がやるのは、Play（エディタ上でゲームを動かすこと）で触って、手触りと見た目を判断することです。

ただ、任せられるようになると今度は別の問題が出てきました。エージェントを役割ごとに分けすぎて、私の確認作業が増えたことです。

まとめ

アセットクレジット

このプロジェクトでは、Meshy の3Dモデル、Mixamo（Adobe）のリギングと一部のモーション、Unity Asset Store の複数の有料アセットを使用しています。

前作・SNS

前作の2Dゲーム「Princess Vanguard」（ブラウザで遊べます）
- itch.io: https://subaru33jp.itch.io/princess-vanguard
- フリーゲーム夢現: https://freegame-mugen.jp/roleplaying/game_15623.html
- デモ動画: https://youtu.be/J8aooF3N8AA
開発中の3Dアクション（YouTube）: https://youtu.be/SGDOwYSBr2s
X: https://x.com/PuddingAthlete