Como Usar o Cursor AI com Godot (Configuração Passo a Passo 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. */}

O Cursor não tem um botão para Godot. Não há uma integração para instalar, nenhuma entrada no marketplace de plugins que funde magicamente os dois. O que acontece na pratica e mais simples e um pouco mais manual: o Cursor e um editor de código, um projeto Godot e uma pasta de arquivos, e você aponta o Cursor para essa pasta e ensina as duas ferramentas a cooperar. Feito corretamente, você tem uma das melhores experiências de programação com IA disponível apontada diretamente para o seu GDScript. Feito errado, o Cursor escreve com confiança código do Godot 3 no seu projeto Godot 4 e adivinha nomes de nos que não existem.

Este guia mostra a configuração e um ciclo prático de editar, verificar e jogar. Nós criamos o Summer Engine, uma engine nativa de IA compatível com Godot 4, e explicamos onde a conexão com a engine pode ajudar.

Antes de começar: o que essa configuração realmente é

O Cursor edita os arquivos de texto de um projeto Godot: .gd, .tscn, .tres e project.godot. O Cursor Agent também pode executar comandos de terminal e ler a saída, conforme as configurações e permissões.

O Cursor não é a engine Godot. Um comando pode iniciar o Godot e informar alguns erros; um servidor MCP pode oferecer outras ferramentas do editor. Nenhuma dessas checagens substitui a inspeção visual e o teste jogado. Mantenha o Godot aberto ao lado do Cursor para verificar cada alteração.

Passo 1: Abra seu projeto Godot no Cursor

Abra o Cursor, escolha Open Folder e selecione a raiz do seu projeto Godot (a pasta que contém project.godot). O Cursor agora vê cada script, cena e arquivo de configuração e pode editar em todos eles.

Um hábito imediato: mantenha os dois aplicativos abertos lado a lado, o Godot em um lado com a árvore de cenas e o jogo rodando, o Cursor no outro com seus scripts. Você vai alternar constantemente entre "pedir ao Cursor para escrever isso" e "rodar no Godot para ver se funcionou".

Passo 2: Instale a extensão godot-tools para GDScript

Esse e o passo que a maioria das pessoas pula, e e o que impede o Cursor de escrever besteira.

O Cursor e construído sobre o ecossistema de extensões do VS Code, então a extensão oficial godot-tools funciona diretamente. Abra o painel de Extensions, busque por "godot-tools" e instale. Ela se conecta ao servidor de linguagem embutido do Godot, o que oferece completao precisa de GDScript, documentação ao passar o mouse, ir para a definição e, fundamentalmente, sintaxe que corresponde a sua versão real do Godot em vez do que o modelo adivinhou.

Para a conexão entrar em vigor, o editor Godot precisa estar rodando com seu servidor de linguagem habilitado (ativado por padrão, porta 6005). Com os dois rodando, as completações GDScript do Cursor vem da API real da engine em vez de dados de treinamento genéricos.

Usuários de C#: instale a extensão C# e as ferramentas C# para Godot. Os modelos lidam com Godot C# pelo menos tão bem quanto com GDScript, pois há muito mais código C# publico, então a qualidade de linguagem e alta; as mesmas ressalvas de consciência de projeto abaixo ainda se aplicam.

Passo 3: Faça o Godot abrir scripts no Cursor

Agora, clicar duas vezes em um script no Godot abre o editor de scripts interno do Godot. Aponte-o para o Cursor para que seu fluxo de trabalho seja consistente.

No Godot, va em Editor Settings, Text Editor, External. Marque Use External Editor. Defina Exec Path para o executável do Cursor, e defina Exec Flags para a forma goto do Cursor: {project} --goto {file}:{line}:{col} (esse flag e o argumento de linha de comando literal do Cursor para pular para uma linha). Agora clicar duas vezes em qualquer script na árvore de cenas do Godot o abre no Cursor na linha exata, e você permanece em um editor para todo o trabalho com código.

E um detalhe pequeno que remove uma fricção constante. Sem isso, você acaba com código metade escrito no editor do Godot e metade no Cursor, que e como você cria buffers desatualizados e dores de cabeça com conflitos.

Passo 4: Adicione um servidor Godot MCP se precisar

O Cursor lê arquivos .tscn como texto. Um servidor Godot MCP pode oferecer ferramentas estruturadas de cena, dependendo da implementação. Verifique as ferramentas e permissões do servidor escolhido. Configure-o no mcp.json do Cursor seguindo as instruções do servidor. Se ele puder ler cenas, pergunte quais nós estão sob Player e compare a resposta com o Godot. Sem MCP, o Cursor ainda edita scripts e executa comandos de terminal permitidos.

Passo 5: Escreva sua primeira edição com IA

Com o projeto aberto, a extensão instalada e, idealmente, um servidor MCP conectado, você esta pronto. Os dois fluxos que você usara com mais frequência:

• Edição inline (Cmd/Ctrl+K): Selecione um bloco de GDScript, pressione o atalho, descreva a mudança. Bom para "converta isso em uma máquina de estados" ou "adicione um cooldown a este ataque".
• Composer / chat: Descreva uma funcionalidade no chat e deixe o Cursor planejar e aplicar edições em vários arquivos. Bom para "adicione um sistema de coleta de moedas com um contador no HUD".

Um primeiro prompt realista: abra o script do seu personagem, selecione o código de movimento, Cmd+K, e escreva "adicione um salto duplo que reinicia quando o personagem toca o chão, sintaxe Godot 4". O Cursor propõe um diff. Revise antes de aceitar, porque e aqui que o problema do Godot 3 aparece.

A armadilha do Godot 3 (e como elimina-la)

A reclamação mais comum sobre IA e Godot e que o assistente escreve código Godot 3: você pede movimento e recebe KinematicBody2D e move_and_slide(velocity) com a assinatura antiga, ou yield onde você precisa de await. Os dados de treinamento publicos são fortemente enviesados para o Godot 3, então um modelo sem orientação recorre a ele.

Três correções, em ordem de impacto:

1. A extensão godot-tools (Passo 2) corrige boa parte disso pelo servidor de linguagem, que conhece a sua API real.
2. Uma regra de projeto. O Cursor permite que você adicione regras nas configurações ou em um arquivo .cursor/rules. Adicione: "This is a Godot 4.x project. Use await, @export, @onready, CharacterBody2D/CharacterBody3D, the velocity property with move_and_slide() (no argument), and Callable-based signal connect syntax. Never use Godot 3 APIs." Isso orienta cada geração.
3. Um arquivo de exemplo. Cole um script Godot 4 correto do seu projeto no contexto. Os modelos combinam a API do código próximo de forma agressiva, então um bom exemplo vale mais que um parágrafo de instruções.

Com os três em vigor, o vazamento para Godot 3 desaparece em sua maior parte.

Verifique a alteração e depois jogue a cena

Se o Godot estiver instalado e comandos de terminal forem permitidos, o Cursor pode importar recursos e verificar a inicialização do editor após uma pequena alteração:

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

Esse início verifica importação e carregamento do editor, não a jogabilidade. Se o projeto tiver uma cena principal, uma execução de 120 iterações pode mostrar outros erros de inicialização ou script:

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

Use o caminho completo do executável do Godot se necessário. Os exemplos seguem a documentação oficial de linha de comando do Godot. Depois jogue a cena afetada e confira comportamento, visual, controles e som.

Onde o Summer Engine se encaixa

O Summer Engine oferece ferramentas ligadas à engine para consultar projeto, cenas, jogo e diagnósticos. Um editor externo também pode usar terminal e MCP quando configurado. O que importa são as ferramentas disponíveis e os resultados que você consegue verificar; ambos os caminhos precisam de um teste jogado por uma pessoa. Você pode manter o Cursor como editor e usar o servidor MCP do Summer.

Para comparar, veja Cursor com Godot versus Summer Engine e assistentes de IA para Godot.

Lista de verificação rápida

1. Abra no Cursor a pasta com project.godot e instale godot-tools.
2. Se precisar, configure o Cursor como editor externo e adicione um servidor MCP do Godot.
3. Faça uma pequena alteração para Godot 4 e revise o diff.
4. Execute um comando limitado e permitido do Godot e leia a saída.
5. Jogue a cena afetada e confira o resultado visual.

A versão resumida

O Cursor faz mais do que editar arquivos: seu agente pode executar comandos permitidos do Godot e ler a saída. Uma checagem headless não substitui a revisão visual nem o teste jogado. O editor de desktop do Summer e a exportação local são gratuitos; Tarefas cobradas de IA hospedada e geração de assets exigem conta e podem consumir créditos pagos. Créditos por cadastro não são garantidos. Confira os preços atuais antes de uma tarefa paga.