Introduction to Godot’s editor

This tutorial will run you through Godot’s interface. We’re going to look at the Project Manager, docks, workspaces and everything you need to know to get started with the engine.

Gerenciador de Projetos

Quando você executa a Godot, a primeira janela que vê é o Gerenciador de Projetos. Como você não possui projetos, haverá uma janela perguntando se você deseja abrir a biblioteca de assets, clique em cancelar, vamos voltar a essa janela depois.

../../_images/project_manager_first_open.png

Agora você deve ver o gerenciador de projetos. Ele te permite criar, remover, importar ou jogar projetos de jogo.

../../_images/editor_ui_intro_project_manager_01.png

No canto superior direito, você encontra um menu suspenso para alterar o idioma do editor.

../../_images/editor_ui_intro_project_manager_02.png

A partir da guia Modelos, você pode baixar modelos e demonstrações de projeto de código aberto para lhe ajudar a aprender mais rápido. Apenas selecione o modelo ou demo desejado, clique em baixar, uma vez que tenha terminado de baixar, clique em instalar e escolha onde você quer que o projeto fique. Você pode aprender mais sobre isso em About the Asset Library.

../../_images/editor_ui_intro_project_manager_03.png

Criar ou importar um projeto

Para criar um novo projeto, clique no botão Novo Projeto à direita. Dê um nome, escolha uma pasta vazia do seu computador para salvá-lo e escolha um renderizador.

../../_images/editor_ui_intro_project_manager_04.png

Clique no botão Navegar para abrir o navegador de arquivos e escolher um local, ou digite o caminho da pasta no campo Caminho do Projeto.

../../_images/editor_ui_intro_project_manager_05.png

Quando você ver uma marca verde na direita, significa que o motor detectou uma pasta vazia. Você também pode clicar no botão Criar Pasta perto do nome do seu projeto e uma pasta vazia vai ser criada com aquele nome para o projeto.

Por último, você precisa escolher qual renderizador usar (OpenGL ES 3.0 ou OpenGL ES 2.0). As vantagens e desvantagens de cada um estão listadas para ajudá-lo a escolher, e você pode consultar Differences between GLES2 and GLES3 para mais detalhes. Observe que você pode alterar o backend nas configurações do projeto, se mudar de ideia depois. Para este tutorial qualquer backend está bom.

Quando estiver tudo pronto, clique em Criar e Editar. Godot vai criar o projeto pra você e abrir ele no editor.

Na próxima vez que abrir o Godot, você verá seu novo projeto na lista. Um duplo clique nele fará abri-lo no editor.

../../_images/editor_ui_intro_project_manager_06.png

Você pode importar projetos existentes de maneira similar, usando o botão Importar. Localize a pasta que contém o projeto ou o arquivo project.godot para importá-lo e editá-lo.

../../_images/editor_ui_intro_project_manager_08.png

Quando o caminho da pasta está correto, você vê uma marca verde de confirmação.

../../_images/editor_ui_intro_project_manager_09.png

Your first look at Godot’s editor

Welcome to Godot! With your project open, you should see the editor’s interface with menus along the top of the interface and docks along the far extremes of the interface on either side of the viewport.

../../_images/editor_ui_intro_editor_interface_overview.png

No topo, da esquerda para a direita, você pode ver os menus principais, as workspaces e os botões de teste.

The FileSystem dock is where you’ll manage your project files and assets.

../../_images/editor_ui_intro_dock_filesystem.png

The Scene dock lists the active scene’s content and the Inspector allows for the management of the properties of a scene’s content.

../../_images/editor_ui_intro_dock_inspector.png

No centro, você tem a Barra de Ferramentas no topo, onde você encontra as ferramentas para mover, redimensionar ou travar objetos da sua cena. A barra se altera conforme você alterna entre diferentes espaços de trabalho.

../../_images/editor_ui_intro_editor_02_toolbar.png

The Bottom Panel is the host for the debug console, the animation editor, the audio mixer… They are wide and can take precious space. That’s why they’re folded by default.

../../_images/editor_ui_intro_editor_03_animation_player.png

Os Espaços de Trabalho

Você pode ver quatro botões de espaços de trabalho no topo: 2D, 3D, Script e AssetLib.

Você usará o Espaço de trabalho 2D para todos os tipos de jogos. Além de ser onde os jogos 2D são desenvolvidos, este espaço de trabalho é onde você pode criar as suas interfaces de usuário (UI). Pressione F1 (ou Alt + 1 no macOS) para acessá-lo.

../../_images/editor_ui_intro_editor_04_2d_workspace.png

No Espaço de Trabalho 3D, você pode trabalhar com malhas, luzes e projetar níveis para jogos 3D. Pressione F2 (ou Alt + 2 no macOS) para acessá-lo.

../../_images/editor_ui_intro_editor_05_3d_workspace.png

Repare no botão Perspectiva abaixo da barra de ferramentas, ele abre uma lista de opções relacionadas ao ponto de vista 3D.

../../_images/editor_ui_intro_editor_06_3d_workspace.png

Nota

Leia Introduction to 3D para saber mais sobre Espaço de Trabalho 3D.

O espaço de trabalho Script é um editor de código completo, com um depurador, um rico auto-completar e referência de código embutida. Pressione F3`(ou :kbd:`Alt + 3 no macOS) para acessá-lo e F4 para pesquisar na referência.

../../_images/editor_ui_intro_editor_06_script_workspace_expanded.png

Para procurar informações sobre uma classe, método, propriedade, constante ou sinal na engine enquanto você escreve um script, pressione o botão “Procurar Ajuda” no canto superior direito do espaço de trabalho de Script.

../../_images/editor_ui_intro_script_search_documentation.png

Uma nova janela surgirá. Procure pelo item que você quer encontrar informações a respeito.

../../_images/editor_ui_intro_script_search_help_window.png

Clique no item que você está procurando e pressione abrir. A documentação para o item será apresentada no espaço de trabalho de script.

../../_images/editor_ui_intro_script_class_documentation.png

Finalmente, o AssetLib é uma biblioteca de complementos, scripts e assets gratuitos para usar nos seus projetos.

Modificar a interface

Godot’s interface lives in a single window. You cannot split it across multiple screens although you can work with an external code editor like Atom or Visual Studio Code for instance.

Mover e redimensionar painéis

Clique e arraste na borda de qualquer painel para redimensioná-lo horizontal ou verticalmente.

../../_images/editor_ui_intro_editor_07.png

Clique no ícone de três-pontos no topo de qualquer painel para alterar sua localização.

../../_images/editor_ui_intro_editor_08.png

Vá para o menu Editor > Configurações do Editor para um ajuste fine na aparência e comportamento.