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

Imparare nuove funzionalità

Godot è un motore di gioco ricco di funzionalità. C'è molto da imparare su di esso. Questa pagina spiega come usare il manuale online, il riferimento integrato di codice, e unirti alle comunità online per imparare nuove funzionalità e tecniche.

Sfruttare al meglio questo manuale

Quello che stai leggendo ora è il manuale utente. Documenta ciascuno dei concetti del motore e delle funzionalità disponibili. Se vuoi imparare un nuovo argomento, puoi iniziare navigando nella sezione corrispondente di questo sito web. Il menu a sinistra ti consente di esplorare argomenti generali, mentre la barra di ricerca ti aiuterà a trovare pagine più specifiche. Se esiste una pagina per un determinato tema, spesso si collegherà a più contenuti al riguardo.

Il manuale ha un riferimento classi complementare che spiega le funzioni e le proprietà disponibili di ciascuna classe in Godot durante la programmazione. Mentre il manuale copre caratteristiche generali, concetti e come utilizzare l'editor, il riferimento riguarda l'uso dell'API (Application Programming Interface) di scripting di Godot. Puoi accedervi sia online sia offline. Ti consigliamo di sfogliare il riferimento offline, dall'editor Godot. Per fare ciò, vai su Aiuto -> Cerca aiuto o premi F1.

Per sfogliarlo online, vai alla sezione Riferimento alle classi del manuale.

La pagina di riferimento di una classe indica:

1. Dove la classe esiste nella gerarchia di ereditarietà. Puoi cliccare sui collegamenti in alto per passare alle classi padre e vedere le proprietà e i metodi che un tipo eredita.

   

2. Un riassunto del ruolo e dei casi d'uso della classe.

3. Una spiegazione delle proprietà, metodi, segnali, enumerazioni e costanti della classe.

4. Collegamenti a pagine del manuale che descrivono ulteriormente la classe.

Nota

Se il manuale o il riferimento alla classe contengono informazioni insufficienti o mancanti, apri un issue nel repository ufficiale godot-docs su GitHub per segnalarlo.

Puoi tenere premuto Ctrl (macOS Cmd) e poi passare il mouse su un testo, ad esempio il nome di una classe, proprietà, metodo, segnale o costante, per sottolinearlo, quindi Ctrl + Click (macOS Cmd + Click) per accedervi.

Imparare a pensare come un programmatore

Insegnare le basi della programmazione e come pensare come uno sviluppatore di giochi va oltre lo scopo della documentazione di Godot. Se sei nuovo con la programmazione, ti consigliamo due ottime risorse gratuite per iniziare:

1. Il tutorial di GDQuest Impara GDScript da zero è un tutorial interattivo completamente gratuito e open source, che viene utilizzato dai principianti per imparare il linguaggio di programmazione GDScript che Godot offre. È disponibile come un applicazione su desktop , oppure nel browser.

2. Se preferisci i libri, dai un'occhiata all'ebook gratuito Automate The Boring Stuff With Python di Al Sweigart.

Imparare con la comunità

Godot ha una comunità di utenti in continua crescita. Se sei bloccato su un problema o hai bisogno di aiuto per capire meglio come realizzare qualcosa, puoi chiedere aiuto ad altri utenti su una delle tante ` comunità attive <https://godotengine.org/community>`_.

Il miglior posto per fare domande e trovare risposte è il sito ufficiale Godot Forum. Queste risposte appaiono nei risultati dei motori di ricerca e sono salvate, consentendo ad altri utenti di beneficiare dalle discussioni sulla piattaforma. Appena fatta una domanda, è possibile condividerne il collegamento su altre piattaforme social. Prima di fare una domanda, assicurati di cercare risposte esistenti che potrebbero risolvere il tuo problema su questo sito o tramite il tuo motore di ricerca preferito.

Formulare bene le tue domande e fornire dettagli aiuterà gli altri a dare risposte migliori e più rapidamente. Quando si fanno domande, raccomandiamo di includere le seguenti informazioni:

1. Descrivi il tuo obiettivo. Dovresti spiegare cosa stai cercando di ottenere dal punto di vista progettuale. Se stai avendo difficolta cercando di far funzionare una soluzione, potrebbe esserci una soluzione diversa e più semplice che raggiunge lo stesso obiettivo.

2. Se si tratta di un errore, condividi l'esatto messaggio d'errore. Puoi copiare l'esatto messaggio d'errore dal pannello inferiore Debugger nell'editor, cliccando sull'icona Copia errore. Sapere quello che dice può aiutare i membri della comunità a identificare meglio la causa dell'errore.

3. Se si tratta di codice, condividi un esempio del codice. Gli altri utenti non saranno capaci di aiutarti senza vedere il tuo codice. Condividi il codice direttamente come testo. Per fare ciò, puoi copiare e incollare una piccola sezione di codice in una chat box, oppure usare un sito come Pastebin per condividere lunghi file.

4. Condividi una cattura dello schermo del tuo pannello Scena insieme al tuo codice. La maggior parte del codice che scrivi influisce sui nodi nelle tue scene. Pertanto, dovresti pensare a tali scene come parte del tuo codice sorgente.

   

   Inoltre, per favore non fare foto col tuo telefono, in quanto la bassa qualità e i riflessi dello schermo rendono difficile comprendere l'immagine. Il tuo sistema operativo dovrebbe avere uno strumento integrato per catturare lo schermo con il tasto PrtSc (Stampa Schermo) (macOS: usa Cmd + Shift + 3 per una cattura a schermo intero, maggiori informazioni qui).

   Alternativamente, puoi usare un programma come ShareX su Windows o FlameShot su Windows/macOS/Linux.

5. Condividere un video del tuo gioco in esecuzione può essere davvero utile per risolvere i problemi del tuo gioco. Puoi usare programmi come OBS Studio e Screen to GIF per registrare il tuo schermo.

   Puoi usare un servizio come streamable o un cloud provider per poi caricare e condividere gratuitamente i tuoi video.

6. Se non stai utilizzando la versione stabile di Godot, per favore menziona la versione utilizzata. La risposta può essere differente in base alle funzionalità disponibili e l'evoluzione continua dell'interfaccia.

Seguire queste linee guida massimizzerà le probabilità di ricevere la risposta che stai cercando. Risparmieranno tempo sia a te sia alle persone che ti aiutano.

Tutorial della comunità

Questo manuale punta a provvedere un riferimento comprensivo per le funzionalità di Godot. Oltre alla serie introduttiva 2D e 3D, non contiene alcun tutorial per implementare specifici generi di gioco. Se stai cercando un tutorial per creare un gioco di ruolo, un piattaforme, o altri, per favore dai uno sguardo a Tutorial e risorse, il quale elenca alcuni contenuti creati dalla comunità di Godot.