Introduzione

func _ready():
    $Label.text = "Hello world!"

Benvenuto sulla documentazione ufficiale di Godot Engine, il motore di gioco 2D e 3D gratuito, open source e sostenuto dalla community. Scoprirai uno strumento potente ma anche user-friendly che potrai utilizzare per sviluppare ogni tipo di gioco, per qualunque piattaforma senza alcun tipo di limitazione.

Questa pagina ha lo scopo di dare una panoramica del motore di gioco e dei contenuti della documentazione, in modo da indicarti come iniziare se sei un principiante o dove trovare informazioni su una specifica funzionalità.

Prima di cominciare

La pagina Tutorials and resources elenca dei video tutorial creati dalla comunità. Se preferisci il video al testo potrebbe valere la pena dare un' occhiata.

In caso di problemi con uno dei tutorial o del progetto, è possibile trovare aiuto nelle seguenti risorse: ref: Canali della community <doc_community_channels>, in particolare la community Godot su Discord, sezione Q&A (domande e risposte) e IRC.

Riguardo a Godot Engine

Un motore di gioco è uno strumento complesso, per cui è difficile presentare Godot in poche parole. In ogni caso qui c'è una presentazione, che sei libero di utilizzare come una breve descrizione di Godot Engine.

Godot Engine è un motore di gioco ricco di funzionalità, multi piattaforma, per creare giochi 2D e 3D da un'unica interfaccia. Godot offre un ampio set di strumenti base, in modo da permettere agli utenti di focalizzarsi sullo sviluppo dei giochi senza sforzarsi nello studio. I giochi possono essere esportati in un click su numerose piattaforme di gioco, inclusi i sistemi desktop (Linux, macOS, Windows), mobili (Android, iOS) e web (HTML5).

Godot è completamente gratuito e open source sotto la permissiva licenza MIT. Nessuna clausola annessa, nessuna royalty, niente. I giochi degli utenti sono di loro proprietà, fino all'ultima riga di codice del motore. Lo sviluppo di Godot è completamente indipendente e guidato dalla community, dando agli utenti la possibilità di aiutare a dare forma al motore di gioco in modo che sia sempre all'altezza delle loro aspettative. Godot è supportato dall'organizzazione no-profit Software Freedom Conservancy .

Per un'occhiata più approfondita al motore, siete incoraggiati a leggere ulteriormente questa documentazione, in particolar modo il tutorial Passo passo.

Riguardo la documentazione

Questa documentazione è continuamente scritta, corretta, modificata e migliorata dai membri della community di Godot Engine. Viene modificata via file testuali basati sul linguaggio di markup reStructuredText e poi viene compilata in un documento web statico/offline utilizzando i programmi open source Sphinx e ReadTheDocs.

Nota

È possibile contribuire alla documentazione di Godot attraverso l'apertura di un issue o inviando le patch attraverso una pull request al repository presente su GitHub, oppure traducendo nella propria lingua su Hosted Weblate.

Tutti i contenuti sono coperti dalla licenza Creative Commons Attribution 3.0 (CC-BY 3.0), con attribuzione "Juan Linietsky, Ariel Manzur and the Godot Engine community".

Struttura della documentazione

Questa documentazione è organizzata in cinque sezioni con una distribuzione di contenuti sbilanciata in maniera impressionante – ma il modo in cui è organizzata dovrebbe essere abbastanza intuitivo:

  • La sezione Informazioni Generali contiene questa introduzione così come informazioni sul sistema, la sua storia, la licenza applicata, gli autori, eccetera. La sezione contiene anche le Domande frequenti.
  • La sezione Per iniziare è il principale motivo per l'esistenza di questa documentazione visto che contiene tutte le informazioni necessarie su come utilizzare il motore per creare videogiochi. Inizia con il tutorial Passo passo che dovrebbe essere il punto di inizio per tutti i nuovi utenti.
  • La sezione Tutorial può essere letta in caso di necessità ed in ogni ordine. Questa sezione contiene vari tutorial e documentazione orientati verso specifiche funzionalità del sistema.
  • La sezione Sviluppo è orientata ad utenti avanzati e sviluppatori che vogliano contribuire allo sviluppo di Godot; contiene informazioni su come compilare Godot Engine, come sviluppare moduli in C++ o plugin per l'editor.
  • La sezione Comunità contiene informazioni su come contribuire allo sviluppo del motore di gioco e sulla vita della community, per esempio: come segnalare bug, aiutare con la documentazione, eccetera. Contiene inoltre riferimenti ai vari canali di comunicazione tra cui IRC e Discord e una lista di tutorial raccomandati, creati da terze parti, esterni a questa documentazione.
  • Infine la sezione Riferimento classe contiene la documentazione della Godot API, disponibile anche direttamente all'interno dell'editor. Questa documentazione è generata automaticamente da un file all'interno del repository principale, i file generati automaticamente non sono pertanto destinati ad essere modificati direttamente. Vedere la sezione Contribute to the Class Reference per ulteriori informazioni.

In aggiunta a questa documentazione potresti voler dare un'occhiata ai vari progetti demo di Godot.

Divertiti durante la lettura e nel creare giochi con Godot Engine!