Cómo usar Cursor AI con Godot (guía paso a paso para 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 no tiene un botón para Godot. No hay ninguna integración que instalar, ninguna entrada en un marketplace de plugins que fusione mágicamente ambas herramientas. Lo que ocurre en realidad es más sencillo y un poco más manual: Cursor es un editor de código, un proyecto de Godot es una carpeta de archivos, y apuntas Cursor a esa carpeta y enseñas a las dos herramientas a cooperar. Bien configurado, tienes uno de los mejores entornos de programación con IA disponibles apuntando directamente a tu GDScript. Mal configurado, Cursor escribe con toda la confianza código de Godot 3 en tu proyecto de Godot 4 y adivina nombres de nodos que no existen.

Esta guía explica la configuración y un ciclo práctico de edición, comprobación y juego. Creamos Summer Engine, un motor nativo de IA compatible con Godot 4, y explicamos dónde puede ayudar una conexión con el motor.

Antes de empezar: qué es realmente esta configuración

Cursor edita los archivos de texto de un proyecto Godot: .gd, .tscn, .tres y project.godot. Cursor Agent también puede ejecutar comandos de terminal y leer su salida si lo permiten la configuración y los permisos.

Cursor no es el motor Godot. Un comando puede iniciar Godot y mostrar algunos errores; un servidor MCP puede ofrecer otras herramientas del editor. Ninguna de esas pruebas sustituye la inspección visual y la prueba de juego. Mantén Godot abierto junto a Cursor para revisar cada cambio.

Paso 1: Abrir tu proyecto de Godot en Cursor

Abre Cursor, elige Open Folder y selecciona la raíz de tu proyecto de Godot (la carpeta que contiene project.godot). Cursor ahora ve cada script, escena y archivo de configuración, y puede editar a través de todos ellos.

Un hábito inmediato: mantén ambas aplicaciones abiertas una al lado de la otra, Godot en una mitad con el árbol de escena y el juego en ejecución, Cursor en la otra con tus scripts. Cambiarás constantemente entre "pedirle a Cursor que escriba esto" y "ejecutarlo en Godot para ver si funcionó".

Paso 2: Instalar la extensión godot-tools para GDScript

Este es el paso que la mayoría de la gente se salta, y es el que evita que Cursor escriba tonterías.

Cursor está construido sobre el ecosistema de extensiones de VS Code, por lo que la extensión oficial godot-tools funciona directamente. Abre el panel de Extensions, busca "godot-tools" e instálala. Se conecta al servidor de lenguaje integrado de Godot, lo que te da autocompletado preciso de GDScript, documentación al pasar el cursor, saltar a la definición y, lo más importante, sintaxis que coincide con tu versión real de Godot en lugar de lo que el modelo supuso.

Para que la conexión se active, el editor de Godot debe estar en ejecución con su servidor de lenguaje habilitado (activado por defecto, puerto 6005). Con ambos en marcha, los completados de GDScript de Cursor se obtienen de la API real del motor en lugar de datos genéricos de entrenamiento.

Usuarios de C#: instala la extensión de C# y las herramientas de Godot C# en su lugar. Los modelos manejan Godot C# al menos igual de bien que GDScript porque hay mucho más código público en C#, así que la calidad del lenguaje es alta; las mismas advertencias sobre conciencia del proyecto que se describen a continuación siguen aplicando.

Paso 3: Hacer que Godot abra scripts en Cursor

Ahora mismo, al hacer doble clic en un script en Godot se abre el editor de scripts integrado de Godot. Apúntalo a Cursor para que tu flujo de trabajo sea coherente.

En Godot, ve a Editor Settings, Text Editor, External. Marca Use External Editor. Establece Exec Path con la ruta al ejecutable de Cursor, y ajusta Exec Flags al formato goto de Cursor: {project} --goto {file}:{line}:{col} (ese flag es el argumento de línea de comandos literal de Cursor para saltar a una línea). Ahora al hacer doble clic en cualquier script en el árbol de escena de Godot, se abre en Cursor en la línea exacta, y te quedas en un solo editor para todo el trabajo de código.

Es un detalle pequeño que elimina una fricción constante. Sin él acabas con código escrito a medias en el editor de Godot y a medias en Cursor, que es como terminas con buffers desactualizados y dolores de cabeza con las versiones.

Paso 4: Añadir opcionalmente un servidor MCP de Godot

Cursor lee los archivos .tscn como texto. Un servidor MCP de Godot puede ofrecer herramientas de escena estructuradas según su implementación. Revisa sus herramientas y permisos. Configúralo en el mcp.json de Cursor según las instrucciones del servidor. Si puede leer escenas, pregunta qué nodos hay bajo Player y compara la respuesta con Godot. Sin MCP, Cursor puede editar scripts y ejecutar comandos de terminal permitidos.

Paso 5: Escribir tu primera edición con IA

Con el proyecto abierto, la extensión instalada y, idealmente, un servidor MCP conectado, estás listo. Los dos flujos que más usarás:

• Edición en línea (Cmd/Ctrl+K): Selecciona un bloque de GDScript, pulsa el atajo, describe el cambio. Ideal para "convertir esto en una máquina de estados" o "añadir un tiempo de enfriamiento a este ataque".
• Composer / chat: Describe una funcionalidad en el chat y deja que Cursor planifique y aplique ediciones en varios archivos. Ideal para "añadir un sistema de recolección de monedas con un contador en el HUD".

Un primer prompt realista: abre tu script del jugador, selecciona el código de movimiento, Cmd+K, y escribe "añadir un doble salto que se reinicia cuando el jugador toca el suelo, sintaxis Godot 4". Cursor propone un diff. Revísalo antes de aceptarlo, porque aquí es donde aparece el problema de Godot 3.

La trampa de Godot 3 (y cómo eliminarla)

La queja más común sobre IA y Godot es que el asistente escribe código de Godot 3: pides movimiento y obtienes KinematicBody2D y move_and_slide(velocity) con la firma antigua, o yield donde necesitas await. Los datos de entrenamiento públicos están sesgados fuertemente hacia Godot 3, así que un modelo sin guía recurre a él.

Tres soluciones, por orden de impacto:

1. La extensión godot-tools (Paso 2) corrige gran parte mediante el servidor de lenguaje, que conoce la superficie real de tu API.
2. Una regla de proyecto. Cursor te permite añadir reglas en la configuración o en un archivo .cursor/rules. Añade: "Este es un proyecto Godot 4.x. Usa await, @export, @onready, CharacterBody2D/CharacterBody3D, la propiedad velocity con move_and_slide() (sin argumento), y la sintaxis de conexión de señales basada en Callable. No uses nunca APIs de Godot 3." Esto orienta cada generación.
3. Un archivo de ejemplo. Pega un script correcto de Godot 4 de tu proyecto como contexto. Los modelos adoptan agresivamente la API del código cercano, así que un buen ejemplo vale más que un párrafo de instrucciones.

Con los tres en su lugar, la filtración de Godot 3 desaparece casi por completo.

Comprueba el cambio y luego juega la escena

Si Godot está instalado y se permiten comandos de terminal, Cursor puede importar los recursos y comprobar el inicio del editor tras un cambio pequeño:

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

Este arranque comprueba la importación y la carga del editor, no el comportamiento del juego. Si el proyecto tiene una escena principal, una ejecución de 120 iteraciones puede mostrar otros errores de inicio o de script:

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

Usa la ruta completa del ejecutable de Godot si hace falta. Estos ejemplos siguen la guía oficial de línea de comandos de Godot. Después juega la escena afectada y revisa personalmente el comportamiento, la imagen, los controles y el sonido.

Dónde encaja Summer Engine

Summer Engine ofrece herramientas conectadas al motor para consultar el proyecto, las escenas, el juego y los diagnósticos. Un editor externo también puede usar herramientas de terminal y MCP con la configuración adecuada. Lo importante es qué herramientas están disponibles y qué resultados puedes verificar; ambos métodos necesitan una prueba de juego humana. Puedes seguir usando Cursor como editor junto con el servidor MCP de Summer.

Para comparar herramientas, consulta Cursor con Godot frente a Summer Engine y asistentes de IA para Godot.

Lista de verificación de la configuración

1. Abre en Cursor la carpeta con project.godot e instala godot-tools.
2. Si lo necesitas, configura Cursor como editor externo y añade un servidor MCP de Godot.
3. Haz un cambio pequeño para Godot 4 y revisa el diff.
4. Ejecuta un comando acotado y permitido de Godot y lee su salida.
5. Juega la escena afectada y comprueba el resultado visual.

La versión corta

Cursor hace más que editar archivos: su agente puede ejecutar comandos permitidos de Godot y leer su salida. Una prueba headless no sustituye la revisión visual ni la prueba de juego. El editor de escritorio de Summer y la exportación local son gratuitos; las tareas alojadas de IA y generación de recursos que se cobran por uso requieren cuenta y pueden consumir créditos de pago. No se garantizan créditos por registro. Consulta los precios actuales antes de una tarea de pago.