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.

Gestore di Progetto

When you launch Godot, the first window you’ll see is the Project Manager. Since you have no projects there will be a popup asking if you want to open the asset library, just click cancel, we’ll look at it later.

../../_images/project_manager_first_open.png

Ora dovresti vedere il Gestore dei Progetti. Esso ti permette di creare, rimuovere, importare o giocare i vari progetti.

../../_images/editor_ui_intro_project_manager_01.png

In the top-right corner you’ll find a drop-down menu to change the editor’s language.

../../_images/editor_ui_intro_project_manager_02.png

Dalla scheda Templates puoi scaricare dei progetti open source e dei progetti dimostrativi per iniziare più in fretta. Semplicemente seleziona il template o la demo che vuoi, clicca download e quando ha finito di scaricare clicca installa e scegli dove vuoi salvare il progetto.

../../_images/editor_ui_intro_project_manager_03.png

Creare o importare un progetto

Per creare un nuovo progetto, clicca il tasto Nuovo Progetto sulla destra. Dagli un nome, scegli una cartella vuota nel tuo computer per salvarlo e scegli il motore di rendering.

../../_images/editor_ui_intro_project_manager_04.png

Click the Browse button to open Godot’s file browser and pick a location or type the folder’s path in the Project Path field.

../../_images/editor_ui_intro_project_manager_05.png

Quando vedi la spunta verde sulla destra, significa che l’engine rileva una cartella vuota . Puoi anche cliccare il tasto «Crea» di fianco al nome del tuo progetto e una cartella vuota verrà creata con quel nome.

A questo punto puoi scegliere il backend per il rendering (OpenGL ES 3.0 or OpenGL ES 2.0). I vantaggi e gli svantaggi di ognuno sono elencati per aiutarti a scegliere, e puoi fare riferimento a Differences between GLES2 and GLES3 per ulteriori dettagli. Nota che puoi cambiare il backend dalle impostazioni del progetto se cambi idea più avanti. Per questo tutorial entrambi vanno bene.

Una volta fatto premi su Crea & Modifica. Godot creerà il progetto per te e lo aprirà nell’editor.

The next time you open the project manager, you’ll see your new project in the list. Double click on it to open it in the editor.

../../_images/editor_ui_intro_project_manager_06.png

Si possono importare progetti esistenti in maniera simile, utilizzando il bottone Importa. Trova la cartella che contiene il progetto o il file project.godot per importarlo e modificarlo.

../../_images/editor_ui_intro_project_manager_08.png

Se il percorso della cartella è corretto vedrai un segno di spunta verde.

../../_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

In alto, da sinistra a destra, sono visibili i menù principali, gli spazi di lavoro, e i bottoni di playtest.

Il dock FileSystem è dove potrai gestire i file e le risorse del tuo progetto.

../../_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

In the center, you have the Toolbar at the top, where you’ll find tools to move, scale or lock your scene’s objects. It changes as you jump to different workspaces.

../../_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

Gli spazi di lavoro

Nella parte superiore sono visibili quattro pulsanti dell’area di lavoro: 2D, 3D, Script e AssetLib.

You’ll use the 2D workspace for all types of games. In addition to 2D games, the 2D workspace is where you’ll build your interfaces. Press F1 (or Alt + 1 on macOS) to access it.

../../_images/editor_ui_intro_editor_04_2d_workspace.png

Nel 3D workspace puoi utilizzare modelli, luci e progettare livelli per giochi 3D. Premi F2 (oppure Alt + 2 su macOS) per accedervi.

../../_images/editor_ui_intro_editor_05_3d_workspace.png

Si noti il tasto [Prospettiva] sotto la barra degli strumenti: apre una lista di opzioni in relazione alla vista 3D.

../../_images/editor_ui_intro_editor_06_3d_workspace.png

Nota

Leggi Introduction to 3D per più dettagli riguardo l’area di lavoro 3D.

The Script workspace is a complete code editor with a debugger, rich auto-completion, and built-in code reference. Press F3 (or Alt + 3 on macOS) to access it, and Shift + F1 to search the reference.

../../_images/editor_ui_intro_editor_06_script_workspace_expanded.png

Per cercare informazioni riguardanti una classe, metodo, proprietà, costante o segnale nell’engine mentre stai scrivendo uno script, premi il bottone «Cerca aiuto» in alto a destra nella Script workspace.

../../_images/editor_ui_intro_script_search_documentation.png

Comparirà una nuova finestra. Cerca l’elemento di cui vuoi trovare informazioni a riguardo.

../../_images/editor_ui_intro_script_search_help_window.png

Clicca sull’elemento che stavi cercando e clicca apri. La documentazione dell’elemento verrà mostrata nella Script workspace.

../../_images/editor_ui_intro_script_class_documentation.png

Infine, la AssetLib è una libreria di componenti aggiuntivi, script e risorse gratuiti e open source da utilizzare nei tuoi progetti.

Modificare l’interfaccia

L’interfaccia di Godot risiede in un’unica finestra. Non è possibile dividerla in più schermate, anche se è possibile lavorare con un editor di codice esterno come per esempio Atom o Visual Studio.

Spostare e ridimensionare i pannelli

Fare clic e trascinare sul bordo di qualsiasi pannello per ridimensionarlo orizzontalmente o verticalmente.

../../_images/editor_ui_intro_editor_07.png

Fare clic sull’icona con i tre punti nella parte superiore di qualsiasi dock per modificarne la posizione.

../../_images/editor_ui_intro_editor_08.png

Andare al menu Editor e Editor Settings per ottimizzare l’aspetto dell’editor.