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.

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:

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.