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

Introduzione agli strumenti XR

Out of the box Godot gives you all the basic support to setup an XR project. XR specific game mechanics however need to be implemented on top of this foundation. While Godot makes this relatively easy this can still be a daunting task.

Per questo motivo Godot ha sviluppato un toolkit chiamato Godot XR Tools che implementa molte delle meccaniche di base presenti nei giochi XR, dalla locomozione all'interazione con gli oggetti fino all'interazione con l'interfaccia utente.

Questo toolkit è progettato per funzionare sia con i runtime OpenXR sia WebXR. Lo useremo come base per la nostra documentazione. Aiuta gli sviluppatori a partire con il piede giusto, ma per casi d'uso più specifici, creare la propria logica è altrettanto valido. In questo caso, gli strumenti XR possono essere di aiuto come ispirazione.

Installazione degli strumenti XR

Continuing on from our project we started in Configurazione del XR we want to add in the Godot XR Tools library. This can be downloaded from the Godot XR Tools releases page. Find the latest release, and under Assets, download the godot-xr-tools.zip file. You can also find it in the Asset Store with the title "Godot XR Tools".

Se stai usando il file zip, una volta scaricato, decomprimilo. Noterai che i file sono contenuti in una sottocartella godot-xr-tools. Dentra questa cartella troverai una cartella addons. È questa cartella che devi copiare per intero nella cartella del tuo progetto Godot. Il tuo progetto dovrebbe ora apparire più o meno così:

Ora apri il tuo progetto in Godot, se non l'hai già fatto, e dagli circa un minuto affinché siano importate tutte le risorse dell'estensione. Se ti viene chiesto di impostare il percorso di Blender, basta cliccare sull'opzione per disabilitare l'importazione da Blender e riavviare l'editor.

Al termine dell'importazione, potresti notare la comparsa di diversi messaggi del tipo "failed to load script". È normale, bisogna solo abilitare l'estensione nelle impostazioni del progetto.

Next open the Project menu and select Project Settings... Now go to the Plugins tab and enable the plugin.

Dopodiché, bisogna chiudere e riaprire il progetto affinché tutto sia abilitato correttamente.

Mani base

Giusto per farci un'idea, aggiungeremo alcuni componenti standard che abbelliscono la nostra scena, a cominciare dalle mani per il nostro giocatore.

OpenXR supporta il tracciamento completo delle mani, tuttavia al momento esistono notevoli differenze in capacità tra i diversi runtime XR.

As a reliable alternative Godot XR Tools comes with a number of rigged hand scenes that react on trigger and grip inputs of your controller. These hands come in low and high poly versions, come in a few configurations, a number of animation files to control finger positions and a number of different textures.

Nell'albero di scene, seleziona il nodo XRController3D della mano sinistra. Ora clicca sul pulsante Istanzia scena figlia per aggiungere una scena figlia. Clicca sull'interruttore Componenti aggiuntivi così da poter cercare nella cartella addon. Poi cerca left_hand_low.tscn e selezionalo.

Come puoi vedere dal percorso di questa scena, i modelli low poly si trovano nella sottocartella lowpoly mentre i modelli high poly si trovano nella sottocartella highpoly. Sarebbe preferibile usare le versioni low poly se intendi pubblicare il tuo gioco sui dispositivi mobili.

La mano predefinita che abbiamo scelto è solo una mano. Le altre opzioni sono:

• tac_glove - la mano sta indossando un guanto con le dita scoperte

• full_glove - la mano sta indossando un guanto che copre l'intera mano

Infine, ogni mano è disponibile in una versione physics. Questa versione mostra tutte le ossa. Vedremo come utilizzarla in un altro tutorial.

Ripetiamo lo stesso per la mano destra.

Maggiori informazioni

Nelle prossime pagine continueremo ad aggiungere funzionalità al nostro progetto tutorial utilizzando gli strumenti di Godot XR. Ulteriori informazioni dettagliate sul toolkit sono disponibili nelle pagine di aiuto del toolkit.