Cursor AIをGodotで使う方法（2026年版ステップバイステップガイド）

{/* IMAGE: Hero showing a Godot project open in Cursor on the left with an AI edit mid-stream in a GDScript file, and the Godot editor on the right with the scene tree visible. A dashed line connects them labeled "you wire these two together." 1200x630, illustration. */}

CursorにはGodot専用のボタンはありません。二つをシームレスに統合するプラグインや、自動で連携してくれるマーケットプレイスのエントリも存在しません。実際のところはもっとシンプルで、少しだけ手作業が必要です。CursorはコードエディタであってGodotプロジェクトはファイルの集まりに過ぎないため、そのフォルダをCursorで開き、二つのツールを連携させる設定をするだけです。正しく設定すれば、トップクラスのAIコーディング体験をGDScriptに直接向けることができます。設定を誤ると、CursorはGodot 4のプロジェクトに自信満々でGodot 3のコードを書き込み、存在しないノード名を推測し続けます。

このガイドでは設定方法と、編集・確認・プレイの実用的な流れを説明します。私たちはGodot 4互換のAIネイティブエンジンSummer Engineを開発しており、エンジン連携が役立つ場面も説明します。

始める前に：このセットアップが実際に何なのかを理解する

CursorはGodotプロジェクトのテキストファイル（.gd、.tscn、.tres、project.godot）を編集します。Cursor Agentはターミナルコマンドも実行でき、設定と権限が許す範囲で出力を読めます。

Cursor自体はGodotエンジンではありません。コマンドからGodotを起動して一部のエラーを確認でき、MCPサーバーが追加のエディターツールを提供する場合もあります。それでも映像と操作感の確認には自分でシーンをプレイする必要があります。GodotもCursorと並べて開いておきましょう。

ステップ1：GodotプロジェクトをCursorで開く

Cursorを起動し、「フォルダを開く」を選択してGodotプロジェクトのルート（project.godotが含まれるフォルダ）を指定します。これでCursorはすべてのスクリプト、シーン、設定ファイルを参照して編集できるようになります。

一つ習慣にしておきたいのは、GodotとCursorを常に並べて開いておくことです。片方にシーンツリーと実行中のゲームを表示するGodot、もう片方にスクリプトを表示するCursorという配置です。「Cursorに書いてもらう」と「Godotで実行して確認する」の繰り返しが作業の基本になります。

ステップ2：GDScript用にgodot-tools拡張機能をインストールする

ほとんどの人が飛ばすステップですが、Cursorが意味のないコードを書かないようにするための重要なステップです。

CursorはVS Codeの拡張機能エコシステムをベースにしているため、公式のgodot-tools拡張機能がそのまま使えます。拡張機能パネルを開き、「godot-tools」を検索してインストールしてください。これによりCursorがGodotの内蔵言語サーバーに接続され、正確なGDScript補完、ホバードキュメント、定義へのジャンプが使えるようになります。特に重要なのは、AIが推測したものではなく実際に使っているGodotバージョンに合った構文が得られることです。

この接続を有効にするには、Godotエディタが言語サーバーを有効にした状態で起動している必要があります（デフォルトで有効、ポート6005）。両方が起動していると、CursorのGDScript補完は汎用的なトレーニングデータではなく実際のエンジンAPIから引き出されます。

C#ユーザーの方は、C#拡張機能とGodot C#ツールをインストールしてください。公開されているC#コードが非常に多いため、モデルはGDScriptと同等かそれ以上にGodot C#を扱えます。言語の品質は高いですが、後述するプロジェクト認識の注意事項は同様に当てはまります。

ステップ3：GodotがスクリプトをCursorで開くように設定する

現在、GodotでスクリプトをダブルクリックするとGodot内蔵のスクリプトエディタが開きます。ワークフローを統一するために、Cursorを外部エディタとして指定します。

Godotで Editor Settings > Text Editor > External を開きます。Use External Editor にチェックを入れ、Exec Path にCursorの実行ファイルのパスを設定します。そして Exec Flags にCursorのgotoコマンド形式 {project} --goto {file}:{line}:{col} を設定します（このフラグはCursorがコマンドラインで行にジャンプするための引数です）。これでGodotのシーンツリーでスクリプトをダブルクリックすると、Cursorの正確な行位置で開かれ、コードを書く作業は常に一つのエディタで完結します。

小さな設定ですが、常に感じる摩擦を取り除けます。この設定がないと、Godotのエディタで半分書いてCursorで半分書くという状況になり、バッファの不整合やマージの問題が生じやすくなります。

ステップ4：必要ならGodot MCPサーバーを追加する

Cursorは.tscnファイルをテキストとして読みます。Godot MCPサーバーは、実装によって構造化されたシーンツールを提供できます。選んだサーバーのツールと権限を確認し、その手順に従ってCursorのmcp.jsonに設定します。シーンを読める場合はPlayerの下にあるノードを質問し、Godotで答えを照合してください。MCPなしでもスクリプト編集と許可されたターミナル確認はできます。

ステップ5：最初のAI編集を行う

プロジェクトが開かれ、拡張機能がインストールされ、理想的にはMCPサーバーも接続されたら準備完了です。最もよく使う二つの操作は次の通りです。

• インライン編集（Cmd/Ctrl+K）： GDScriptのブロックを選択してショートカットを押し、変更内容を入力します。「これをステートマシンに変換して」「この攻撃にクールダウンを追加して」といった用途に適しています。
• Composer / チャット： チャットで機能を説明し、Cursorに複数ファイルにわたる編集を計画・適用させます。「コイン取得システムとHUDカウンターを追加して」といった用途に適しています。

現実的な最初のプロンプトとして、プレイヤースクリプトを開いて移動コードを選択し、Cmd+Kを押して「プレイヤーが床に触れたときにリセットされるダブルジャンプを追加して。Godot 4の構文で」と入力してみましょう。CursorはDiffを提案します。承認する前に必ず確認してください。ここでGodot 3の問題が現れやすいからです。

Godot 3の落とし穴（そしてその対処法）

AIとGodotの組み合わせでよく聞かれる不満は、AIがGodot 3のコードを書いてしまうことです。移動処理を頼むとKinematicBody2Dと古いシグネチャのmove_and_slide(velocity)が返ってきたり、awaitが必要なところにyieldが書かれたりします。公開されているトレーニングデータはGodot 3に大きく偏っているため、指示がなければモデルはGodot 3に引き寄せられます。

対策を効果順に三つ紹介します。

1. godot-tools拡張機能（ステップ2）は言語サーバーを通じて多くの問題を修正します。あなたが実際に使うAPIを理解しているからです。
2. プロジェクトルール。 Cursorの設定または.cursor/rulesファイルにルールを追加できます。次のように記述してください：「これはGodot 4.xのプロジェクトです。await、@export、@onready、CharacterBody2D/CharacterBody3D、引数なしのmove_and_slide()でvelocityプロパティを使用し、Callable形式のシグナルconnect構文を使ってください。Godot 3のAPIは絶対に使わないでください。」これで生成されるコードがすべてこのルールに従います。
3. 一つのサンプルファイル。 プロジェクトから正しいと分かっているGodot 4のスクリプトをコンテキストに貼ります。モデルは近くにあるコードのAPIに強く合わせようとするため、良いサンプル一つが長い説明よりも効果的です。

三つすべてを実施するとGodot 3への逆戻りはほぼなくなります。

編集を確認してからシーンをプレイする

Godotがインストールされ、ターミナル操作が許可されていれば、小さな編集の後でCursorにリソースのインポートとエディター起動の確認を依頼できます。

godot --headless --path "/path/to/project" --import

これはインポートとエディター起動を確認する例で、ゲームの動作を証明するものではありません。メインシーンがある場合は、反復回数を区切った実行で起動時やスクリプトのエラーを確認できます。

godot --headless --path "/path/to/project" --quit-after 120

必要ならGodot実行ファイルのフルパスを使ってください。コマンドはGodot公式のコマンドラインガイドに基づきます。最後に対象シーンをプレイし、変更した動作、映像、操作、音を自分で確認します。

Summer Engineが提供するもの

Summer Engineには、プロジェクト、シーン、プレイ、診断を扱うエンジン連携ツールがあります。外部エディターも適切に設定すればターミナルやMCPツールを使えます。実際に使えるツールと確認できる結果が大切で、どちらの方法でも人によるプレイ確認が必要です。Cursorを編集に使いながらSummerのMCPサーバーを利用することもできます。

詳しくはCursorとGodot対Summer Engineの比較とGodot向けAIコーディング支援をご覧ください。

クイックセットアップチェックリスト

1. project.godotのあるフォルダーをCursorで開き、godot-toolsを入れます。
2. 必要なら外部エディターとGodot MCPサーバーを設定します。
3. Godot 4向けの小さな変更を加え、差分を確認します。
4. 許可されたインポート確認か反復回数を区切った起動確認を実行し、出力を読みます。
5. 対象シーンを自分でプレイし、見た目を確認します。

まとめ

Cursorはファイル編集だけでなく、許可されたGodotコマンドの実行と出力の確認もできます。ヘッドレス確認は映像やプレイの確認に代わりません。Summerのデスクトップエディターとローカルのエクスポートは無料です。ホスト型AIとアセット生成にはアカウントと有料クレジットが必要で、登録時のクレジット付与は保証されません。有料の作業を始める前に現在の料金を確認してください。