Como Exportar Jogo Godot para Windows: Templates, Presets e .exe Final

Exportar jogo Godot para Windows é rápido quando você já fez uma vez: instala os export templates, cria um preset, aperta um botão e sai um .exe. O problema é a primeira vez, porque o Godot não exporta nada "de fábrica" e o caminho até o executável tem três ou quatro pegadinhas que ninguém te conta: template com versão errada, ícone que não muda, jogo que roda no editor mas quebra no export.

Esse guia cobre o processo inteiro no Godot 4.x: templates, preset, geração do .exe, exportação por linha de comando e os erros que mais aparecem. No final você tem um executável que roda em qualquer Windows 64 bits, sem instalar nada na máquina do jogador.

O que o Godot precisa pra exportar

O editor do Godot não contém os binários das plataformas de destino. Quando você exporta, o que acontece por baixo é simples: o Godot empacota o conteúdo do seu projeto num arquivo .pck e cola ele num executável pré-compilado, o export template. Esse template é um Godot "vazio", compilado pra plataforma alvo, que só sabe abrir um .pck e rodar.

Disso saem duas consequências práticas:

• Você precisa baixar os templates antes do primeiro export. É download único por versão do editor.
• O template tem que ser exatamente da mesma versão do editor, incluindo o sufixo. Godot 4.3-stable só aceita template 4.3-stable. Um 4.3-rc1 não serve, e essa incompatibilidade é a causa número um de erro de export em fórum.

Instalando os export templates

Dois caminhos, os dois levam ao mesmo lugar:

1. Pelo menu: Editor > Manage Export Templates (Gerenciar Modelos de Exportação), botão Download and Install. O Godot baixa o pacote da versão certa sozinho.
2. Pelo aviso no diálogo de export: se você abrir Project > Export sem templates instalados, aparece um aviso em vermelho no rodapé com um link pra baixar. Clica e pronto.

O pacote é um arquivo .tpz com os templates de todas as plataformas (Windows, Linux, macOS, Android, iOS, Web), então é um download de algumas centenas de megabytes. Se a sua internet for instável ou a máquina não tiver acesso, dá pra baixar o .tpz manualmente na página de downloads do site do Godot e instalar pelo mesmo menu com Install from File.

Como exportar jogo Godot para Windows: o preset

Com os templates instalados, vá em Project > Export. Clique em Add e escolha Windows Desktop. Isso cria um preset, que é o conjunto de configurações daquele alvo de exportação. O preset fica salvo no arquivo export_presets.cfg na raiz do projeto, então a configuração persiste e vai junto no versionamento se você quiser.

As opções que importam de verdade:

Binary Format > Architecture. Deixe x86_64. É o Windows de praticamente todo mundo hoje. O x86_32 só vale se você tem certeza que o público roda máquina de 32 bits, o que em 2026 é raríssimo.

Embed PCK. Por padrão o export gera dois arquivos: MeuJogo.exe e MeuJogo.pck. O .exe sem o .pck do lado não abre. Marcando Embed PCK, o conteúdo é embutido dentro do próprio executável e você distribui um arquivo só. Pra jogo pequeno e médio, eu marco sempre: elimina o suporte de "baixei só o .exe e não abre".

Resources > Export Mode. O padrão exporta todas as resources do projeto, e serve pra maioria dos casos. Os filtros de inclusão e exclusão embaixo aceitam padrões tipo *.json ou data/*.txt, e são importantes por um motivo: arquivos que não são resources do Godot (um .txt, um .csv, um .json que você lê com FileAccess) não entram no .pck automaticamente. Se o seu jogo lê esses arquivos, adicione o padrão deles no filtro "Include", senão funciona no editor e quebra no export.

Application > Icon e metadados. Aqui você aponta o ícone do executável (um arquivo .ico) e preenche nome do produto, versão e copyright. Tem um detalhe importante nessa parte que merece seção própria logo abaixo, porque é a pegadinha mais comum depois dos templates.

Debug ou release

No rodapé do diálogo de export tem o botão Export Project e um checkbox Export With Debug. A diferença:

• Debug: binário maior e mais lento, mas com mensagens de erro detalhadas e suporte a debug remoto. Use pra testar em outra máquina e investigar problema que só aparece fora do editor.
• Release: o que você publica. Otimizado, sem instrumentação de debug.

Pra distribuir, desmarque o checkbox. Parece óbvio, mas build de debug publicada por descuido acontece bastante.

Ícone e metadados: você precisa do rcedit

Essa é a pegadinha que mais frustra: você configura o ícone no preset, exporta, e o .exe continua com o ícone padrão do Godot. Não é bug. Pra gravar ícone e metadados (versão, nome do produto) dentro de um executável Windows, o Godot usa uma ferramenta externa chamada rcedit, e ela não vem junto.

O caminho:

1. Baixe o rcedit-x64.exe na página de releases do projeto rcedit no GitHub (é mantido pelo time do Electron).
2. Salve em qualquer pasta fixa, por exemplo C:\godot-tools\rcedit-x64.exe.
3. No Godot, vá em Editor > Editor Settings > Export > Windows e aponte o campo rcedit pro arquivo.
4. Exporte de novo. Agora o ícone e as informações de versão entram no .exe.

Sobre o ícone em si: o icon.svg do projeto não vira ícone de executável sozinho. Você precisa de um .ico de verdade, de preferência com múltiplas resoluções embutidas (16, 32, 48, 64, 128 e 256 pixels), porque o Windows usa tamanhos diferentes na barra de tarefas, no Explorer e no atalho. Ferramentas gratuitas como o GIMP exportam .ico multi-resolução a partir de um PNG.

Detalhe que vale saber: o rcedit também roda via Wine, então dá pra exportar um .exe com ícone certinho a partir do Linux. O export pra Windows não exige uma máquina Windows.

Exportando por linha de comando

Quando o projeto cresce, exportar clicando em botão cansa, e se você quiser automatizar build (num CI, num script de release), a linha de comando resolve. O Godot exporta headless usando o nome do preset:

# Release, usando o preset "Windows Desktop" do export_presets.cfg.
# Rode na pasta do projeto (onde está o project.godot).
godot --headless --export-release "Windows Desktop" "build/MeuJogo.exe"

# Versão de debug do mesmo preset:
godot --headless --export-debug "Windows Desktop" "build/MeuJogo-debug.exe"

Três cuidados:

• O nome entre aspas tem que bater exatamente com o nome do preset no diálogo de export. Não é o nome da plataforma, é o nome do preset.
• A pasta de destino (build/ no exemplo) precisa existir antes, o Godot não cria.
• O godot do comando é o executável do editor. No Windows, ou você adiciona ele no PATH ou chama pelo caminho completo.

Isso é tudo que um pipeline de build precisa: o mesmo comando que você roda na sua máquina roda num GitHub Actions com a versão headless do Godot.

Erros comuns (e como resolver cada um)

Depois de acompanhar muita gente travando nessa etapa, a lista de suspeitos é curta e quase sempre é um destes.

"No export template found at expected path"

Template não instalado ou de versão diferente do editor. Abra Editor > Manage Export Templates e confira se a versão listada como instalada é idêntica à do editor, incluindo o sufixo (stable, rc, beta). Atualizou o Godot? Baixe os templates de novo, os da versão antiga não servem.

O .exe abre e fecha na hora, ou não abre

Na maioria das vezes é o .pck faltando: você copiou só o .exe pra outra pasta ou outra máquina e deixou o .pck pra trás. Ou distribui os dois arquivos sempre juntos, ou marque Embed PCK no preset e esqueça o problema. Pra investigar qualquer crash no export, gere uma build de debug e rode pelo terminal: as mensagens de erro aparecem no console e apontam a causa.

Funciona no editor, quebra no export

Aqui tem duas causas clássicas.

A primeira: arquivo que não entrou no .pck. Como falei na seção do preset, arquivos não-resource (.json, .txt, .csv) precisam estar no filtro de inclusão. No editor tudo funciona porque os arquivos estão soltos no disco; no export, só existe o que foi empacotado.

A segunda: tentar escrever em res://. No editor isso até funciona, porque res:// é uma pasta de verdade no seu disco. No jogo exportado, res:// aponta pra dentro do .pck e é somente leitura. Save, configuração, qualquer coisa que o jogo grava vai em user://:

# Errado no export: res:// é somente leitura dentro do .pck.
# Certo: user:// aponta pra uma pasta gravável do usuário.
# No Windows: %APPDATA%\Godot\app_userdata\NomeDoProjeto

func salvar_jogo(dados: Dictionary) -> void:
    var arquivo = FileAccess.open("user://save.json", FileAccess.WRITE)
    arquivo.store_string(JSON.stringify(dados))

func carregar_jogo() -> Dictionary:
    if not FileAccess.file_exists("user://save.json"):
        return {}
    var arquivo = FileAccess.open("user://save.json", FileAccess.READ)
    return JSON.parse_string(arquivo.get_as_text())

Se você precisa de um comportamento diferente entre editor e build exportada (caminho de log, cheat de desenvolvimento), use feature tags em vez de gambiarra:

func _ready() -> void:
    if OS.has_feature("editor"):
        print("rodando dentro do editor")
    else:
        print("rodando numa build exportada")

"O Windows protegeu o computador" (SmartScreen)

Quando alguém baixa seu .exe da internet e executa, o Windows mostra a tela azul do SmartScreen dizendo que impediu um aplicativo não reconhecido. Isso acontece com todo executável sem assinatura digital, não é nada errado com o seu jogo. O jogador clica em "Mais informações" e depois "Executar assim mesmo".

As saídas reais: assinar o executável com um certificado de code signing (custa dinheiro e é coisa pra quando o jogo é um produto sério) ou distribuir por uma loja como Steam ou itch.io, onde esse atrito praticamente some porque o launcher da loja cuida da execução. Pra build que você manda pra amigos testarem, avise sobre a tela e siga o jogo. Antivírus de terceiros também marcam falso positivo em .exe desconhecido de vez em quando, pelo mesmo motivo de reputação.

Uma janela de console preta abre junto do jogo

No preset, em Debug > Export Console Wrapper, o Godot pode gerar um segundo executável .console.exe que abre com terminal visível, útil pra ver logs no Windows. Se uma janela preta está abrindo junto do seu jogo, ou você distribuiu o .console.exe em vez do .exe normal, ou a opção está como "Debug and Release". Deixe em "Debug Only" e distribua o executável sem o sufixo.

Fechando

O fluxo inteiro, depois da primeira configuração, é: Project > Export, preset Windows Desktop, Export Project, pronto. O que faz a primeira vez doer são os pré-requisitos escondidos: templates da versão exata, rcedit pro ícone, .pck junto do .exe (ou embutido), e a disciplina de gravar em user:// em vez de res://.

Minha sugestão é não deixar o export pro final do projeto. Exporte cedo, na primeira semana, mesmo com o jogo pela metade. Cada um desses problemas é trivial de resolver isolado e chato de resolver em véspera de lançamento, todos de uma vez. Build que exporta desde o início é build que não te trai no dia que importa.