スクリプトは通るのに 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 |
| 6 | Anchor / 9スライスと伸縮ルール | 解像度変更で全体がずれる |
| 7 | アトラスと Draw Call | コントロールごとに巨大 PNG |
| 8 | インポートパスがプロジェクト規約と一致 | MCP が Prefab パスを見つけられない |
| 9 | ロジック接続前に commit | AI がスクリプトを直し参照が消える |
| 10 | 16:9 と目標縦画面で各1回 Play | Editor ウィンドウ比率だけテスト |
構造化取り込み 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つの実践
- プロンプトは検証可能に——Prefab パス、ノード名、Play 後10秒以内に見えるべき状態を書く。
- 小さくコミット——一度に1変更:「開始ボタン → ステージ読み込み」、次に敵 AI。
- 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 の組み合わせが一般的です。
続きを読む
こちらの記事もおすすめです
ゲームUIデザイン:従来ワークフローとAI生成+VberAI Studio分割の比較
PS/Figmaの手作業スライスとVberAI Studioを比較。UIの取り込みまたはAI生成、自動レイヤー分割、レイヤーPSDまたは画像セットの書き出し。効果、手順、デモ動画。
- game-ui-design
- game-ui-designer-flow
- ui-slicing
- AIGC
Godot MCP vs 手書き:AI にエディタを任せる判断基準
Godot のシーン/シグナル慣例に沿い、VberAI Godot MCP が効く場面と、手書き GDScript を守るべき場面を短く整理する。
- godot-mcp
- vberai
- comparison
- GDScript
Godot向けリアルタイムMCPサーバーを構築した方法
VberAIのGodot MCPアーキテクチャ:リアルタイムModel Context ProtocolサーバーがシーンツリーをフリーズさせずにGodotエディターとAIクライアントを橋渡しする仕組み
- vberai
- godot
- mcp
- architecture