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

Impostazioni del progetto

Esistono dozzine di impostazioni che è possibile modificare per controllare l'esecuzione di un progetto, tra cui le impostazioni relative alla fisica, al rendering e alla gestione delle finestre. È possibile cambiare queste impostazioni dalla finestra Impostazioni del progetto, tramite codice o modificando manualmente il file project.godot. Puoi vedere l'elenco completo delle impostazioni nella classe ProjectSettings.

Internamente, Godot memorizza le impostazioni di un progetto in un file project.godot, un file di testo semplice in formato INI. Sebbene questo formato sia leggibile e compatibile con i sistemi di controllo versione, non è il più pratico da modificare. Pertanto, è disponibile la finestra Impostazioni del progetto per modificare tali impostazioni. Per aprire le Impostazioni del progetto, selezionare Progetto > Impostazioni del progetto dal menu principale.

../../_images/project_settings_basic.webp — La finestra delle Impostazioni del progetto

La finestra Impostazioni del progetto serve principalmente per modificare le impostazioni nella scheda Generale. Inoltre, sono presenti schede per la Mappa di input, Localizzazione, Globali, Estensioni e Predefiniti per importatori. L'utilizzo di queste altre schede è documentato altrove.

Modificare le impostazioni del progetto

La scheda Generale della finestra delle impostazioni del progetto funziona in modo molto simile all'ispettore. Visualizza un elenco di impostazioni modificabili del progetto, proprio come le proprietà dell'ispettore. A sinistra è presente un elenco di categorie che si possono usare per selezionare gruppi di impostazioni correlati. È anche possibile cercare un'impostazione specifica attraverso il campo Filtra le impostazioni.

Ogni impostazione ha un valore predefinito. È possibile ripristinare le impostazioni ai loro valori predefiniti cliccando sul pulsante Ripristina (la freccia circolare) accanto a ciascuna proprietà.

Modificare le impostazioni del progetto da codice

È possibile utilizzare set_setting() per modificare il valore di un'impostazione tramite codice:

ProjectSettings.set_setting("application/run/max_fps", 60)
ProjectSettings.set_setting("display/window/size/mode", DisplayServer.WINDOW_MODE_WINDOWED)

ProjectSettings.SetSetting("application/run/max_fps", 60);
ProjectSettings.SetSetting("display/window/size/mode", (int)DisplayServer.WindowMode.Windowed);

Tuttavia, molte impostazioni del progetto vengono lette una sola volta all'avvio del gioco. Dopodiché, modificare l'impostazione tramite set_setting() non avrà alcun effetto. Piuttosto, la maggior parte delle impostazioni ha una proprietà o un metodo corrispondente in una classe come Engine o DisplayServer durante l'esecuzione:

Engine.max_fps = 60
DisplayServer.window_set_mode(DisplayServer.WINDOW_MODE_WINDOWED)

Engine.MaxFps = 60;
DisplayServer.WindowSetMode(DisplayServer.WindowMode.Windowed);

In generale, le impostazioni del progetto sono duplicate durante l'esecuzione nelle classi Engine, PhysicsServer2D, PhysicsServer3D, RenderingServer, Viewport o Window. Nel riferimento alla classe ProjectSettings, le impostazioni rimandano alla proprietà o al metodo equivalente durante l'esecuzione.

Leggere le Impostazioni del progetto

È possibile leggere le impostazioni del progetto con get_setting() o get_setting_with_override():

var max_fps = ProjectSettings.get_setting("application/run/max_fps")
var window_mode = ProjectSettings.get_setting("display/window/size/mode")

int maxFps = (int)ProjectSettings.GetSetting("application/run/max_fps");
var windowMode = (DisplayServer.WindowMode)(int)ProjectSettings.GetSetting("display/window/size/mode");

Poiché molte impostazioni del progetto vengono lette una sola volta all'avvio, il valore in esse contenuto potrebbe non essere più accurato. In questi casi, è preferibile leggere il valore dalla proprietà o dal metodo equivalente durante l'esecuzione:

var max_fps = Engine.max_fps
var window_mode = DisplayServer.window_get_mode()

int maxFps = Engine.MaxFps;
DisplayServer.WindowMode windowMode = DisplayServer.WindowGetMode();

Modificare manualmente project.godot

È possibile aprire il file project.godot con un editor di testo e modificare manualmente le impostazioni del progetto. Si noti che se il file project.godot non contiene un valore memorizzato per una determinata impostazione, questo assume implicitamente il valore predefinito. Ciò significa che, se si modifica manualmente il file, potrebbe essere necessario inserire sia il nome dell'impostazione sia il suo valore.

In generale, si consiglia di utilizzare la finestra Impostazioni del progetto piuttosto che modificare manualmente il file project.godot.

Impostazioni avanzate del progetto

../../_images/project_settings_advanced.webp — Le impostazioni avanzate del progetto

Normalmente, sono visualizzate solo alcune impostazioni del progetto. Per visualizzarle tutte, abilita l'opzione Impostazioni avanzate.