← ブログへ

スクリプトは通るのに Hierarchy がズレる?ゲーム開発者向け UI 引き継ぎと MCP チェックリスト

Unity / Godot / Cocos プログラマー向け:Cursor のスクリプト生成が UI シェル層を直せない理由、デザイン取り込み後の受け入れチェック、Unity MCP / Godot MCP を入れるタイミング、Studio から Prefab 出力後のロジック接続。

公開日
  • game-dev-ai
  • Unity MCP
  • Godot MCP
  • Cocos MCP
  • Cursor
  • game-ui-design
  • ui-to-engine
  • unity
  • godot
  • cocos
  • mcp
  • vberai
  • 2026

インディーや小規模チームでよくある壁は「C# / GDScript が書けない」ではなく、スクリプトはコンパイルされるのに Scene を開くと全部ズレることです。ボタンが反応しない、HUD がずれる、UI を1回直すたびに参照を付け直す——こういう話です。

原因は AI モデルの性能ではなく、UI シェルの引き継ぎとゲームプレイロジックを同じツールチェーンで処理しようとしていることにあります。以下では、よくある詰まりどころ、受け入れチェックリスト、そして Engine MCP(Unity MCP / Godot MCP / Cocos MCP)をどの段階で入れるべきかを整理します。


2種類の仕事——1つの AI ツールに両方やらせない

仕事典型的な成果物向いているツール
UI シェルCanvas / Control ツリー、Prefab、アンカー、スライス命名構造化デザイン取り込み(PSD / Figma → エンジン)
ゲームプレイロジックボタンイベント、数値、ステートマシン、Play デバッグCursor / Claude Code + Engine MCP

Cursor、Copilot、Claude Code はデフォルトでリポジトリ内のテキストしか見えません。次のものは見えません:

  • エディターで未保存のシーン変更
  • 現在の選択オブジェクト、Prefab 参照の切断
  • Play モード中の Console と一瞬で変わる UI 状態

そのため AI が .cs を直しても、Hierarchy 上の Btn_Start に OnClick が付いていない——これはプロンプトの問題ではなく、エディターとの橋渡しがないことが原因です。MCP が埋めるのはこの部分です。カテゴリマップ:Godot / Unity 向け AI ツール。


UI 取り込み後:エンジニア側 10 項目チェック

デザインまたは Studio から Prefab が出たら、最初の Play の前に確認してください(Unity UGUI の例。Godot / Cocos も概念は同じ):

#チェック項目よくある失敗
1ルート Canvas / Control と解像度ポリシーCanvas Scaler 誤り、縦画面 Safe Area 切れ
2ヒット領域と装飾レイヤーの分離透明画像が Raycast をブロック
3ボタン normal / pressed / disabled静止画1枚だけ
4テキストが TMP / Label にマップ全画面が表示用画像、ローカライズ不可
5スクリプト向け命名(Btn_*、Panel_*)Layer 47 copy
6Anchor / 9スライスと伸縮ルール解像度変更で全体がずれる
7アトラスと Draw Callコントロールごとに巨大 PNG
8インポートパスがプロジェクト規約と一致MCP が Prefab パスを見つけられない
9ロジック接続前に commitAI がスクリプトを直し参照が消える
1016:9 と目標縦画面で各1回 PlayEditor ウィンドウ比率だけテスト

構造化取り込み vs 手動スライス:Figma → Unity 手動スライスなし、その場 UI 分割。


Engine MCP を入れるタイミング

状況推奨
毎日ゲームプレイを直し、Play / Console を頻繁に見る該当エンジンの MCP を入れる
UI を毎週手切りで作り直している先にシェル(Studio / 規範引き継ぎ)、その後 MCP
スクリプト中心で Scene をほぼ触らないMCP の効果は限定的
Game Jam、当日プレイ可能にしたいStudio で UI + MCP でボタン接続(実例)

Godot MCP はオープンソース——まずワークフロー検証に向いています:インストール · 手書き vs MCP。 Unity / Cocos は公式 Pro パッケージ:Unity MCP インストール · Cocos 3.x。

3エンジン比較:Godot MCP vs Unity MCP vs Cocos MCP。


おすすめの分担(エンジニア視点)

デザインファイル / 全画面 UI 画像
 → AI Studio:取り込み · 分割 · Prefab 出力(Unity / Godot / Cocos)
 → 上記 10 項目をエンジニアが確認
 → Cursor + Engine MCP:OnClick、HUD、数値、Play デバッグ
変更タイプルート
テーマ差し替え / 多言語文案 / 全画面リスキンStudio 再出力(リスキン、翻訳)
手触り、当たり判定、AI、セーブ、バグMCP + 手動レビュー
ダメージ数字、ピクセルフォントビットマップフォント または TMP

覚え方:Studio は殻、MCP は配線。 MCP に HUD 全体をゼロから作らせず、キャンバスツールで戦闘 FSM も書かない。


MCP 接続後:3つの実践

  1. プロンプトは検証可能に——Prefab パス、ノード名、Play 後10秒以内に見えるべき状態を書く。
  2. 小さくコミット——一度に1変更:「開始ボタン → ステージ読み込み」、次に敵 AI。
  3. MCP は QA の代わりにならない——モデルが生成したノード変更も Play が必要。省けるのはクリック数で、テストではない。

Cursor と Claude Code で Unity:Unity MCP ワークフローガイド、Claude Code で Unity MCP 接続。

ツール組み合わせと1週間導入:2026 ゲーム開発 AI 効率化。


よくある質問

Cursor だけで足りない? MCP も要る? スクリプトだけなら十分。Scene ツリー、コンポーネント、Play デバッグに触ると MCP の効果が一気に上がります。

MCP は UI スライスの代わりになる? なりません。MCP はエディター内オブジェクト向け。UI 構造は Prefab レベルの引き継ぎが必要(Studio または規範化 PSD / Figma フロー)。

1エンジンだけでも Studio を学ぶ価値は? UI 改訂で Canvas 作り直しに時間を取られるなら価値あり。UI が最小ならプレースホルダーで十分な場合も。

Godot 小規模プロジェクト、先に何を入れる? まず Godot MCP(オープンソース)で検証。UI 引き継ぎが痛ければ AI Studio を追加。

Unity AI UI Generator と競合する? 競合しません。Unity AI はエディター内 Sprite 寄り。マルチエンジンや PSD/Figma 構造化取り込みでは Studio + MCP の組み合わせが一般的です。

こちらの記事もおすすめです