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...
Editor di script
Introduzione
L'editor di script di Godot Engine è un editor di testo potente e completamente integrato che non solo semplifica il processo di scrittura e debug del codice GDScript, ma consente anche di lavorare con file di testo semplice, offrendo agli sviluppatori un ambiente intuitivo per programmare la logica e i comportamenti di gioco. È in grado di evidenziare il codice, indentarlo automaticamente, verificare la sintassi e molto altro. È inoltre possibile creare punti d'interruzione per aiutare con il debug senza dover passare a un'altra finestra. L'editor di testo funge anche da visualizzatore di riferimenti classe offline, accessibile in diversi modi, come descritto in Riferimento classi integrato.
Funzionalità
Di seguito sono elencate alcune delle funzionalità principali dell'editor di testo:
Editor di codice completamente integrato per GDScript.
Supporto di evidenziazione della sintassi per GDScript e file JSON.
Verifica della sintassi per i file GDScript e JSON.
Supporto per segnalibri e punti d'interruzione.
Indentazione automatica.
Riduzione del codice.
Tema personalizzabile.
Più cursori, abilitabili tramite Alt + Left Click.
Completamento automatico di variabili, funzioni, costanti, ecc.
Refactoring in riga di simboli selezionandoli e premendo Ctrl + D.
Ricerca e sostituzione di massa tra i file del progetto.
Utilizzo
Se utilizzi GDScript nel tuo progetto, l'editor integrato di testo in Godot ti offre tutto il necessario, fungendo da unico punto di riferimento per sfruttare appieno il motore Godot. Quasi tutti i parametri regolabili tramite l'interfaccia utente si possono modificare anche direttamente tramite codice.
Nota
Se desideri utilizzare un editor di testo esterno o preferisci usare C# nel tuo progetto, consulta Utilizzare un editor di testo esterno e Configurare un editor esterno.
Suggerimento
Come per molte altre parti dell'interfaccia di Godot, anche l'editor di testo può essere personalizzato modificandone le impostazioni a proprio piacimento. È possibile accedere a queste impostazioni aprendo Editor > Impostazioni dell'editor e selezionando il gruppo Editor di testo.
È possibile aprire l'Editor di script tramite il pulsante Script nel selettore dello spazio di lavoro, situato nella parte superiore centrale dell'interfaccia di Godot. Alternativamente, è possibile utilizzare il pulsante Apri script accanto a un nodo nel pannello Albero di scene, oppure fare doppio clic su un file .gd o su un file di testo riconosciuto nel pannello Filesystem per aprirlo direttamente nell'Editor di script.
Una volta aperto, vedrai i menu dell'editor di testo in alto, sotto il selettore di scena. Accanto ai menu, troverai i pulsanti per aprire la documentazione online o per cercare all'interno del riferimento classi integrato. Alla destra di questi pulsanti ci sono due frecce di navigazione che ti permettono di navigare la cronologia di visualizzazione. Infine, puoi usare il pulsante "rendi mobile" per separare l'editor di testo dalla finestra di Godot, il che è utile se lavori con più monitor.
Sotto i menu a sinistra, troverai il pannello degli script. Al centro, adiacente al pannello degli script, si trova l'area di codifica. Sotto l'area di codifica si trova la barra di stato, che mostra il numero di errori e avvisi nel codice. Cliccando sulle icone di errore o avviso verrà visualizzato l'elenco degli errori con i numeri di riga. Cliccando su un errore si passerà direttamente alla riga corrispondente. È anche possibile scegliere di ignorare gli avvisi aprendo l'elenco e cliccando su Ignore. La barra di stato consente inoltre di modificare il livello di zoom del codice cliccando sul valore percentuale. È anche possibile utilizzare Ctrl + Mouse Wheel (Cmd + Mouse Wheel su Mac) per ottenere lo stesso effetto. La barra di stato mostra anche la posizione attuale del cursore in termini di riga e colonna, e se l'indentazione usa tabulazioni o spazi.
Molte delle azioni effettuate nell'editor di testo si possono effettuare anche tramite scorciatoie. Le azioni mostrano le scorciatoie corrispondenti accanto a esse. Per un elenco completo delle scorciatoie, consultare scorciatoie dell'editor di testo.
Nelle prossime sezioni esamineremo diversi aspetti dell'editor di testo. Puoi anche selezionare una sezione di seguito per passare direttamente a un argomento specifico:
Pannello di script
Sotto i menu, nel pannello di sinistra, troverete un elenco dei file aperti e delle pagine di documentazione. A seconda del tipo di file, questo elenco avrà un'icona accanto al nome. Ad esempio, l'icona 
indica che è un GDScript. 
indica che è uno script C#. 
indica che è un riferimento a una classe predefinita. Infine, 
indica che si tratta di uno script in esecuzione (consultare annotazione tool per maggiori informazioni). Passando il mouse su un file, apparirà un tooltip contenente la sua posizione relativa nella cartella del progetto.
Sulla barra di stato, cliccare sulla freccia sinistra nasconde il pannello degli script, mentre cliccare sulla freccia destra lo mostra.
Se non hai modificato alcuna impostazione, i nomi dei file potrebbero anche avere una colorazione diversa. Questo ti aiuta a identificare i file modificati di recente, evidenziandoli. Questo comportamento può essere modificato in Editor > Impostazioni dell'editor regolando le proprietà Temperatura di script nella sezione Editor di testo.
La barra dei filtri sopra i nomi dei file introduce una pratica ricerca (senza distinzione tra maiuscole e minuscole) per trovare un file specifico. Anche solo digitando le lettere del nome di un file nella barra, appariranno i file che contengono queste lettere in ordine. Supponiamo che nell'elenco sia presente un file denominato button.gd. Se digiti btn nella barra dei filtri, questo file apparirà nei risultati. Per ripristinare il filtro, cancella la barra dei filtri.
Un asterisco (*) accanto al nome di un file indica che il file contiene modifiche non salvate.
Suggerimento
Se inserisci solo "*" nella barra dei filtri, puoi visualizzare tutti i file non salvati.
È possibile trascinare un file per modificarne l'ordine. Facendo clic centrale su un file, questo viene chiuso. Facendo clic destro su un file, vengono fornite diverse opzioni per salvare o chiudere i file, oppure per copiarne il percorso relativo. In questo menu:
È anche possibile utilizzare Sposta su e Sposta giù per modificare l'ordine dei file, oppure Ordina per ordinare tutti i file in ordine alfabetico. Commuta il pannello degli script nasconde il pannello, che si può visualizzare nuovamente tramite la freccia destra sulla barra di stato. Chiudi documentazione chiude tutti i documenti di riferimento aperti in classe, lasciando aperti solo i file di script. Mostra nel filesystem trova ed evidenzia il file nel pannello Filesystem.
Sotto l'elenco dei file, vedrai il nome del file attualmente aperto. Il pulsante accanto a questo cambia l'ordine dei metodi definiti in questo file da alfabetico a così come appaiono. Sotto c'è la struttura del file. Se si tratta di un file script, conterrà l'elenco dei metodi definiti. Se, tuttavia, è aperta una pagina di riferimento di una classe, quest'area mostrerà l'indice del documento. Cliccando su un elemento in questo elenco si passerà alla rispettiva funzione o sezione nel file. Similmente, la barra Filtra i metodi consente di cercare una funzione o una sezione specifica all'interno del documento selezionato con lo stesso comportamento del filtro degli script.
Menu
I menu dell'editor di testo si trovano sotto il selettore di scena e consentono di accedere a una varietà di strumenti e opzioni, come la gestione dei file, la ricerca e la sostituzione, i controlli di debug e le funzionalità di formattazione del codice.
Suggerimento
Un asterisco (*) accanto a un'azione significa che questa operazione è disponibile anche nel menu contestuale, che si può aprire facendo clic destro nell'editor di codice.
Il menu File offre le seguenti opzioni:
Nuovo script...: apre la finestra di dialogo Nuovo script per creare e aggiungere lo script al progetto. Se la creazione avviene con successo, lo script si aprirà direttamente nell'editor di testo. A seconda della versione di Godot (con o senza supporto C#), è possibile scegliere
.gdo.cscome estensione.Nuovo file di testo...: apre la finestra di dialogo per creare un file di testo semplice in uno dei formati riconosciuti. Godot può anche evidenziare i file
json.Apri...: apre la finestra di dialogo dei file per consentire di esplorare il computer e scegliere un file di testo riconosciuto per aprirlo.
Riapri script chiuso: riapre gli ultimi script chiusi. Puoi usare questa opzione più volte per riaprire altri script chiusi, se ne hai chiuso più di uno.
Apri recenti: fornisce un elenco degli ultimi script aperti. È anche possibile cancellare l'elenco tramite l'opzione fornita in fondo all'elenco.
Salva: salva lo script attualmente selezionato.
Salva con nome...: apre la finestra di dialogo dei file per salvare lo script attualmente aperto con un nome diverso.
Salva tutto: salva tutti gli script aperti non salvati nell'editor di testo. Gli script con modifiche non salvate avranno un asterisco (*) accanto al loro nome nell'elenco degli script.
Ricarica script tool (parziale): se lo script selezionato è di tipo strumento (tool), ricarica lo script per eseguirlo nuovamente.
Copia percorso dello script: copia il percorso relativo dello script attualmente selezionato nel progetto, utilizzando il prefisso
res://.Mostra nel filesystem: trova ed evidenzia il file selezionato nel pannello Filesystem.
Precedente in cronologia: Cambia lo script attivo in quello aperto in precedenza. Questa opzione è utile quando si hanno più script aperti e si desidera ritornare rapidamente all'ultimo script che si stava modificando. Se si è cambiata anche la posizione del cursore di più di 10 righe, sarà necessario prima spostarlo nella posizione precedente nello stesso file.
Cronologia successiva: dopo aver utilizzato Precedente in cronologia per tornare a uno script precedente, questa funzione consente di avanzare nella cronologia dello script, passando agli script a cui si è avuto accesso in precedenza. In modo simile a quanto sopra, se si cambia anche la posizione del cursore di più di 10 righe, sarà prima spostato nella posizione successiva nello stesso file.
Tema: Fornisce opzioni per importare un tema esistente, salvarlo o ricaricarlo. La modifica delle impostazioni del tema avviene tramite le Impostazioni dell'editor.
Chiudi: chiude lo script attivo.
Chiudi tutto: chiude tutti gli script aperti e chiede di salvare se ci sono modifiche non salvate.
Chiudi altre schede: chiude tutti gli script aperti tranne quello selezionato.
Chiudi documentazione: chiude le pagine della documentazione di riferimento alle classi, lasciando solo gli script.
Esegui: se lo script estende EditorScript e si intende eseguirlo senza eseguire il progetto, questa opzione esegue lo script. Consultare Running one-off scripts using EditorScript per maggiori informazioni.
Commuta il pannello degli script: mostra o nasconde il pannello degli script sul lato sinistro dell'editor di testo, consentendo di espandere l'area di codifica disponibile. Per maggiori informazioni sul Pannello script, consultare la sezione precedente.
Il menu Modifica offre diverse opzioni per le operazioni di riga:
Annulla*: consente di annullare l'azione o la serie di azioni più recenti, ripristinando il documento o il codice allo stato precedente prima che le modifiche siano state apportate.
Ripristina*: consente di riapplicare un'azione precedentemente annullata, ripristinando effettivamente l'ultima azione annullata dalla funzione Annulla.
Taglia*: taglia la selezione e la copia negli appunti.
Copia*: copia la selezione negli appunti.
Incolla*: incolla il contenuto degli appunti se contiene testo.
Seleziona tutto*: seleziona tutto il codice nell'editor di testo.
Duplica selezione: copia la selezione e la accoda accanto alla selezione.
Duplica righe: duplica la riga attuale e la aggiunge come nuova riga sotto la riga attuale.
Valuta selezione*: calcola i valori del testo selezionato se contiene solo un'espressione matematica, come
83 * 3opow(2,3).Commuta ritorno a capo automatico: disattiva la barra di scorrimento orizzontale, mandando a capo le righe lunghe alla riga successiva. Si noti che è solo un cambiamento visivo e non sono aggiunte nuove interruzioni di riga.
Riga: fornisce una serie di operazioni di riga. A seconda del file aperto, le opzioni potrebbero anche essere disponibili direttamente nel menu Modifica, anziché in un sottomenu.
Sposta su: sposta la riga attuale o le righe selezionate di una riga verso l'alto.
Sposta giù: sposta la riga attuale o le righe selezionate di una riga verso il basso.
Indenta*: indenta il testo dal cursore o dalle righe selezionate, seguendo l'impostazione di indentazione.
De-indenta*: annulla l'indentazione del testo dal cursore o dalle righe selezionate, seguendo l'impostazione di indentazione.
Elimina riga: elimina la riga attuale o le righe selezionate.
Commuta commento*: Commenta e rimuove il commento dalla riga attuale o dalle righe selezionate. È possibile effettuare la stessa azione selezionando le righe e scegliendo la stessa azione dopo aver fatto clic destro sul testo selezionato.
Raggruppamento: Fornisce una serie di opzioni di riduzione per il testo selezionato. A seconda del file aperto, le opzioni potrebbero anche essere disponibili direttamente nel menu Modifica, anziché in un sottomenu.
Espandi/Riduci riga*: Se il codice nella riga attuale contiene un blocco o una regione di codice sottostante, nasconde questo blocco comprimendo le righe. È quindi possibile espanderlo nuovamente tramite questa opzione, tramite la freccia ">" accanto al numero di riga nell'area di codifica, o cliccando sull'icona con i puntini di sospensione "..." alla fine della riga ridotta.
Riduci tutte le righe: Riduce tutti i blocchi di codice o le regioni di codice nel documento aperto.
Espandi tutte le righe: espande tutti i blocchi di codice e le regioni di codice nel documento aperto.
Crea regione di codice*: racchiude il testo selezionato in una regione di codice riducibile per migliorare la leggibilità di script più grandi. Consultare Tipi integrati per maggiori informazioni.
Richiesta di completamento: suggerisce simboli predefiniti o creati dall'utente per completare automaticamente il codice parzialmente scritto. Le frecce Su e Giù consentono di spostarsi verso l'alto e verso il basso; premendo Invio o Tab si accetta e si aggiunge il simbolo evidenziato al codice. Tab sostituirà anche il testo esistente a destra del cursore.
Rimuovi spazio vuoto a fin di riga: rimuove la spaziatura in eccesso alla fine di ogni riga del file.
Rimuovi ritorni a capo finali: rimuove le nuove righe in più alla fine del file.
Indentazione: fornisce opzioni per l'indentazione del file aperto. A seconda del file aperto, le opzioni potrebbero anche essere disponibili direttamente nel menu Modifica, anziché in un sottomenu.
Converti indentazione in spazi: converte tutta l'indentazione nel file in spazi.
Converti indentazione in tabulazioni: converte tutta l'indentazione nel file in tabulazioni.
Indenta automaticamente: converte l'indentazione delle righe selezionate (o dell'intero file), in base all'impostazione di indentazione.
Converti maiuscole/minuscole: cambia le maiuscole/minuscole del testo selezionato in Maiuscole*, Minuscole* oppure rende maiuscola ciascuna lettera iniziale delle parole.
Evidenziatore di sintassi: consente di scegliere l'evidenziatore di sintassi.
Testo semplice: disattiva l'evidenziazione.
Standard: Evidenziazione predefinita per gli script C#.
JSON: Evidenziazione di sintassi per i file JSON.
GDScript: Evidenziazione di sintassi per i file GDScript.
Il menu Cerca offre le seguenti opzioni:
Trova...: apre la barra di ricerca rapida, sotto la barra di stato, per cercare testo nel file aperto. È possibile passare alla corrispondenza successiva e precedente tramite le frecce su e giù, rispettivamente. Selezionando Maiuscole distinte la ricerca fa distinzione tra maiuscole e minuscole. Selezionando Parole intere significa che il testo non deve contenere lettere o numeri, ma solo simboli e spazi vuoti.
Trova successivo: simile alla freccia in giù, mostra l'occorrenza successiva.
Trova precedente: simile alla freccia in su, mostra l'occorrenza precedente.
Sostituisci...: apre la barra di ricerca e sostituzione, sotto la barra di stato, per trovare il testo e sostituirlo nel file aperto. È possibile scegliere di sostituirli uno o tutti alla volta. Inoltre, è possibile limitare la sostituzione al testo selezionato, spuntando la casella Solo selezione nella barra di ricerca e sostituzione. È anche possibile premere Ctrl + D per selezionare anche l'istanza successiva del testo attualmente selezionato, consentendo di eseguire una sostituzione in riga su più occorrenze.
Trova nei file...: apre una finestra per cercare testo all'interno dei file nella cartella del progetto. Selezionando "Trova..." la ricerca inizia dalla cartella scelta e include le estensioni selezionate nei filtri. I risultati sono mostrati nel pannello inferiore, con il numero di corrispondenze e il numero totale di file trovati, nella scheda Risultati di ricerca. Cliccando su un risultato si apre il file e si passa alla riga corrispondente.
Sostituisci nei file...: apre una finestra per cercare e sostituire il testo con testo diverso all'interno dei file trovati nella cartella del progetto. Dopo aver cliccato su Sostituisci..., è possibile selezionare i file da sostituire attraverso la scheda Risultati di ricerca nel pannello inferiore, spuntandoli e premendo il pulsante Sostituisci tutto.
Avvertimento
Si noti che l'operazione "Sostituisci nei file" non può essere annullata!
Suggerimento
Entrambe le finestre Trova nei file e Sostituisci nei file condividono i pulsanti Cerca... e Sostituisci.... L'unica differenza in quest'ultima finestra è un campo di testo aggiuntivo che compila automaticamente il pannello dei risultati di ricerca quando clicca sul pulsante Sostituisci.... L'operazione di sostituzione è eseguita solo se clicca sul pulsante Sostituisci tutto in questo pannello inferiore, consentendo di modificare anche la parola da sostituire successivamente all'interno di questo pannello.
Aiuto contestuale*: apre l'elenco dei riferimenti alle classi integrate, simile a premere F1 su un simbolo o a scegliere Ricerca simbolo dal menu contestuale.
Il menu Vai a ti consente di navigare facilmente dentro il codice con queste opzioni:
Vai alla funzione...: apre l'elenco delle funzioni a cui passare. È possibile ottenere lo stesso risultato digitando nella barra di filtro dei metodi nel pannello degli script.
Vai alla riga...: Passa al numero di riga inserito nell'editor di codice.
Segnalibri: Contiene azioni per la funzionalità dei segnalibri, che si può utilizzare per orientarsi più facilmente nel codice, ad esempio per individuare una sezione incompleta. Le righe segnate con un segnalibro avranno un simbolo di segnalibro blu a sinistra del numero di riga.
Commuta segnalibro*: aggiunge o rimuove il segnalibro sulla riga in cui si trova il cursore. È anche possibile fare clic destro su una riga per ottenere la stessa cosa.
Rimuovi tutti i segnalibri: rimuove tutti i segnalibri nel documento aperto.
Vai al segnalibro successivo: passa al segnalibro successivo nel documento aperto.
Vai al segnalibro precedente: passa al segnalibro precedente nel documento aperto.
Il menu Segnalibri conterrà anche l'elenco delle righe contrassegnate, incluso il numero di riga e la mostrando parzialmente il contenuto di quella riga.
Punti d'interruzione: i punti d'interruzione sono utili durante il debug del codice. Simile al menu Segnalibri, questo menu consente di aggiungere o rimuovere tali punti, navigare tra di essi e passare direttamente a un punto specifico. Un modo semplice per aggiungere un punto è passare il mouse sull'area vuota a sinistra di un numero di riga. Sarà visualizzato un cerchio rosso sbiadito. Cliccando su di esso sarà aggiunto un punto d'interruzione e il cerchio rimarrà lì. Cliccando su un cerchio, il punto d'interruzione sarà rimosso.
Il menu Debug offre azioni che si possono utilizzare durante il debug. Consultare Strumenti e opzioni di debug nell'editor di script per maggiori informazioni.
Area di programmazione
Nota
Questa sezione tratterà solo le basi della programmazione in termini di interfaccia utente. Per saperne di più sullo scripting in Godot, consultate la documentazione GDScript o Scripting.
L'area di codifica è dove scriverai i tuoi script se utilizzi l'editor integrato di testo. Offre funzionalità di evidenziazione e completamento automatico per aiutarti durante la scrittura del codice.
L'area di codifica mostra i numeri di riga sul lato sinistro. Sotto le frecce di navigazione sul lato destro, è presente una minimappa cliccabile che fornisce una panoramica dell'intero script, consentendo di navigarlo.
Se una riga di codice è lunga abbastanza (più di 80 caratteri normalmente), l'editor di testo visualizzerà una linea verticale che serve da linea guida flessibile. Per una linea guida rigida, questo valore è normalmente impostato su 100 caratteri. Entrambi i valori si possono cambiare, oppure è possibile attivare o disattivare la visualizzazione della linea nelle impostazioni "Aspetto" dell'editor di testo.
Nello script, a sinistra delle definizioni delle funzioni, potresti vedere icone aggiuntive. L'icona 
indica che questa funzione è una sovrascrittura (override) di una funzione esistente. Cliccandoci sopra si apre la documentazione della funzione originale. L'icona 
indica che è un metodo di ricezione di un segnale. Cliccandoci sopra viene mostrata la provenienza del segnale. Un'icona 
a sinistra della riga indica un blocco riducibile. Puoi cliccarci sopra per ridurlo o espanderlo. In alternativa, puoi cliccare anche sull'icona con i puntini di sospensione (...) per espandere un blocco ridotto.
L'esempio seguente riassume il paragrafo precedente. Le righe 52, 56 e 58 sono blocchi riducibili, la riga 57 è una regione di codice con il nome "New Code Region", anch'essa riducibile, e la riga 62 è un blocco ridotto. La riga 53 è un segnalibro, a cui si può accedere rapidamente tramite il menu Vai a > Segnalibri. La riga 55 è un punto d'interruzione che si può utilizzare nel debugging.
È possibile personalizzare molti dei colori dell'editor di testo, come quelli di evidenziazione o persino i colori dei punti d'interruzione o delle icone dei segnalibri. Si possono sperimentare aprendo le impostazioni dell'editor di testo, andando alla sezione Editor > Impostazioni dell'editor > Editor di testo.