Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Introdução ao desenvolvimento do editor
Nesta página, você aprenderá:
As decisões de projeto por trás do editor do Godot.
Como trabalhar eficientemente no código C++ do editor do Godot.
Este guia é voltado para colaboradores atuais ou futuros da engine. Para criar plugins do editor em GDScript, consulte Criando plugins em seu lugar.
Ver também
Se você é novo no Godot, recomendamos ler Filosofia de Design do Godot antes de continuar. Como o editor do Godot é um projeto do Godot escrito em C++, grande parte da filosofia da engine se aplica ao editor.
Escolhas técnicas
O editor do Godot é desenhado usando o renderizador e o sistema de UI do próprio Godot. Ele não depende de um toolkit como GTK ou Qt. Isso é semelhante em espírito a softwares como o Blender. Embora o uso de toolkits facilite alcançar uma aparência "nativa", eles também são bastante pesados e suas licenças não são compatíveis com a do Godot.
O editor é totalmente escrito em C++. Ele não pode conter nenhum código em GDScript ou C#.
Estrutura de diretórios
O código do editor é totalmente autocontido na pasta editor/ do repositório de código-fonte do Godot.
Algumas funcionalidades do editor também são implementadas por meio de módulos. Alguns deles são ativados apenas em builds do editor para diminuir o tamanho do binário dos modelos de exportação. Veja a pasta modules/ no repositório de código-fonte do Godot.
Alguns arquivos importantes no editor são:
editor/editor_node.cpp: Arquivo principal de inicialização do editor. Efetivamente a "cena principal" do editor.
editor/project_manager/project_manager.cpp: Arquivo principal de inicialização do Gerenciador de Projetos. Efetivamente a "cena principal" do Gerenciador de Projetos.
editor/scene/canvas_item_editor_plugin.cpp: O viewport do editor 2D e funcionalidades relacionadas (barra de ferramentas no topo, modos de edição, ajudantes/painéis sobrepostos, ...).
editor/scene/3d/node_3d_editor_plugin.cpp: O viewport do editor 3D e funcionalidades relacionadas (barra de ferramentas no topo, modos de edição, painéis sobrepostos, ...).
editor/scene/3d/node_3d_editor_gizmos.cpp: Onde os gizmos do editor 3D são definidos e desenhados. Este arquivo não tem uma contraparte 2D, pois os gizmos 2D são desenhados pelos próprios nós.
Dependências do editor em arquivos de scene/
Ao trabalhar em um recurso do editor, você pode ter que modificar arquivos nos nós de GUI do Godot, que podem ser encontrados na pasta scene/.
Uma regra a ser mantida em mente é que você não deve introduzir novas dependências para includes de editor/ em outras pastas como scene/. Isso se aplica mesmo se você usar #ifdef TOOLS_ENABLED.
Para tornar a base de código mais fácil de seguir e mais autocontida, a ordem de dependência permitida é:
editor/->scene/->servers/->core/
Isso significa que os arquivos em editor/ podem depender de includes de scene/, servers/ e core/. Mas, por exemplo, embora scene/ possa depender de includes de servers/ e core/, ele não pode depender de includes de editor/.
Atualmente, existem algumas dependências de includes de editor/ em arquivos de scene/, mas elas estão em processo de remoção.
Dicas de desenvolvimento
Para iterar rapidamente no editor, recomendamos configurar um projeto de teste e abri-lo pela linha de comando após compilar o editor. Dessa forma, você não precisa passar pelo Gerenciador de Projetos toda vez que iniciar o Godot.