シリーズ: 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行）

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

Unity MCP とは

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

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

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


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

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

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

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

ルールに書いたこと

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

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

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

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

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

任せた設定作業の例

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

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

人がやること

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

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

まとめ

• Cursor が書いたスクリプトの参照をインスペクターで指定する作業は、人がやる意味が無いと思い、エージェントに任せました。
• 最初から Unity MCP 前提で、エディタ上の配置・設定・保存はエージェントが行い、ルールで「YAML を手で書き換えない」「エラーを確認する」と決めています。
• 次回は、任せすぎて増えた確認作業をどう減らしたかです。→ https://qiita.com/yasuharusmooth/private/8ba5ce8473f161502950

アセットクレジット

このプロジェクトでは、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