godot embed external editor
Um GDExtension que permite incorporar um editor de código externo, como o Visual Studio Code, diretamente em seu editor Godot!
Guia de início rápido

Características
- Anexe e desconecte automaticamente editores de código externos.
- Verifica se o editor de código é relevante para o projeto em questão (por exemplo, a pasta do projeto está aberta dentro dele) sempre que possível.
- Um botão de alternância na barra de guias da cena para anexar e desconectar manualmente o editor de código externo.
- Editores externos suportados:
- Apenas código do Visual Studio por enquanto.
Início rápido
- Certifique-se de que
- você está usando Godot 4.
- você está no Windows.
- nas configurações do editor Godot, o "modo de janela única" está desabilitado (caso contrário, as caixas de diálogo não aparecerão na frente do editor de código).
- nas configurações do editor de Godot, o editor de código externo está habilitado e configurado corretamente (clicar duas vezes em um arquivo de script no explorador de arquivos de Godot deve abrir o editor de sua escolha).
- você segue as instruções de configuração do editor de sua escolha.
- Baixe e extraia o artefato de compilação mais recente ou compile da fonte.
- Copie a pasta
addons
para a pasta do projeto do jogo. - Se Godot estiver em execução, certifique-se de selecionar "Projeto -> Recarregar projeto atual" ou reinicie o editor (GDExtensions não são recarregadas ao vivo, consulte este problema).
- Habilite o plug-in nas configurações do projeto.
- Abra seu editor de código clicando duas vezes em um arquivo de script no explorador de Godot (editores de código não relacionados NÃO serão incorporados por este complemento) - ele deve desaparecer logo após o lançamento.
- Mude para a guia Script e divirta-se!
Configuração por editor
Código do Visual Studio
As seguintes alterações nas configurações podem ser feitas nas configurações do usuário (Ctrl+Vírgula) ou para cada pasta do espaço de trabalho:
- Defina
window.titleBarStyle
como native
. Caso contrário, a barra de título não poderá ser ocultada e a janela do editor poderá ser redimensionada independentemente do seu contêiner. - Certifique-se de que as configurações
window.title
e window.titleSeparator
usem seus valores padrão. Siga estas instruções se você as modificou:- A configuração
window.title
deve conter a string Visual Studio Code
e o nome da pasta atualmente aberta ${rootName}
. Isso é necessário para que o complemento detecte se a instância está com o projeto aberto. - Da mesma forma, o
window.titleSeparator
precisa de espaços em branco à esquerda e à direita para funcionar corretamente.
Se você preferir usar o Visual Studio Code como um editor de texto simples sem seus recursos IDE, considere usar o Modo Zen:
- Defina
zenMode.centerLayout
como false
e zenMode.fullScreen
como false
. - Habilite o Modo Zen executando o comando
View: Toggle Zen Mode
.
Limitações
Este addon é muito experimental e hacky. Estou tentando melhorar isso, mas há algumas coisas que não podem ser corrigidas tão facilmente:
Em geral
- Godot ainda tem problemas para detectar alterações em arquivos de script externos (veja esta edição).
- Solução alternativa: reinicie o editor com "Projeto -> Recarregar projeto atual".
- Não é possível visualizar a documentação no editor sem desanexar o editor.
- Solução alternativa: você pode usar a opção "Listar classes nativas" do VSCode como alternativa.
- Houve congelamentos ocasionais no passado que tentei corrigir. Se eles ainda persistirem, abra um problema.
- Solução alternativa: se você travar, parece que Alt + Tab corrige o problema na maioria das vezes.
- A barra de título do editor não aparece depois de desencaixado.
- Solução alternativa: minimize e restaure a janela.
- A janela incorporada pode ter bordas de janela nativas e às vezes ser redimensionável (por exemplo, quando o depurador quebra).
- Solução alternativa: desencaixe e encaixe a janela novamente.
- A entrada do teclado só será aceita pela janela que estiver em foco (por exemplo, F5 para executar o jogo).
- Godot não muda automaticamente para a guia de script.
- As miniaturas instantâneas das guias de cena não são exibidas na frente do editor de código incorporado.
Código do Visual Studio
- Até que este PR seja concluído e mesclado, a depuração de jogos Godot por meio do VSCode não é possível.
- Raramente, uma faixa preta aparece na parte superior do VSCode, compensando todos os eventos de entrada
- Solução alternativa: reinicie o VSCode para corrigir isso (infelizmente, nem mesmo o comando "Recarregar janela" resolve isso).
Contribuindo
Não pretendo trabalhar neste projeto além dos meus casos de uso pessoais, então agradeceria muito a ajuda de outras pessoas para melhorar esta extensão:
- Suporta outros sistemas operacionais como Mac ou Linux.
- Apoie mais editores, incluindo documentação sobre como configurá-los.
- Corrija problemas e bugs de usabilidade.
Crie problemas para ideias, comentários ou bugs. Abra solicitações pull se você implementou algo. Toda ajuda é apreciada! :)
Se quiser agradecer, você pode doar para patrocinadores do GitHub.