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...
Utilizzo di GridMap
Introduzione
Le Gridmap sono uno strumento per creare livelli di gioco 3D, in modo simile a come funzionano le TileMap nei giochi 2D. Si parte da una collezione preconfigurata di mesh 3D (una MeshLibrary) posizionabili su una griglia, come se si stesse costruendo un livello con una quantità illimitata di mattoncini Lego.
È possibile anche aggiungere collisioni e navigazione alle mesh, proprio come si farebbe con i tasselli di una tilemap.
Progetto d'esempio
Per imparare come funzionano le GridMap, inizia scaricando il progetto di esempio: gridmap_starter.zip.
Decomprimi questo progetto e aggiungilo al Gestore dei progetti tramite il pulsante "Importa". Potrebbe comparire una finestra che indica la necessità di convertire il progetto in una versione più recente di Godot; clicca su Converti project.godot.
Creare una MeshLibrary
Per cominciare, è necessario una MeshLibrary, ovvero una raccolta di singole mesh utilizzabili nella gridmap. Apri la scena "mesh_library_source.tscn" per vedere un esempio di come configurare la libreria di mesh.
Come puoi vedere, questa scena ha un nodo Node3D come radice e un certo numero di nodi MeshInstance3D figli.
Se non hai bisogno di fisica nella scena, allora hai finito. Tuttavia, nella maggior parte dei casi vorrai assegnare dei corpi di collisione alle mesh.
Collisioni
È possibile assegnare manualmente una classe StaticBody3D e una classe CollisionShape3D a ciascuna mesh. Alternativamente, è possibile usare il menu "Mesh" per creare automaticamente il corpo di collisione in base ai dati della mesh.
Tieni presente che un corpo di collisione "Convesso" funzionerà meglio per le mesh semplici. Per forme più complesse, seleziona "Crea corpo statico Trimesh". Una volta che a ciascuna mesh sono stati assegnati un corpo fisico e una forma di collisione, la tua libreria di mesh è pronta all'uso.
Materiali
Solo i materiali provenienti dalle mesh vengono utilizzati per la generazione della libreria di mesh. I materiali impostati sul nodo saranno ignorati.
Lightmap
È possibile precalcolare le lightmap su una GridMap. I dati UV2 delle lightmap saranno riutilizzati dalle mesh, se già presenti. Se i dati UV2 non sono presenti, saranno generati automaticamente durante il precalcolo con una dimensione dei texel nella lightmap di 0,1 unità. Per generare dati UV2 con una dimensione dei texel diversa, è possibile impostare la modalità di illuminazione globale nel pannello Importazione su Lightmap statiche e specificare lì la dimensione dei texel. Questa opzione si deve modificare prima che la scena venga convertita in una MeshLibrary, poiché modificandola dopo non influirà sui dati esistenti nella MeshLibrary.
Oltre questa particolarità, il processo di precalcolo delle lightmap è lo stesso di qualsiasi altra scena 3D. Vedi Utilizzare l'illuminazione globale con lightmap per ulteriori informazioni sul precalcolo delle lightmap.
Formato MeshLibrary
Per riassumere i vincoli specifici del formato MeshLibrary, una scena MeshLibrary ha un Node3D come nodo radice e diversi nodi figli che diventeranno elementi di una MeshLibrary. Ogni figlio del nodo radice deve:
Essere un MeshInstance3D, che diventerà l'elemento della MeshLibrary. Solo questa mesh visiva sarà esportata.
Avere un materiale, nello slot dei materiali della mesh, non negli slot dei materiali del MeshInstance3D.
Avere fino a un solo figlio StaticBody3D, per le collisioni. Lo StaticBody3D deve avere uno o più figli CollisionShape3D.
Avere fino a un solo figlio NavigationRegion3D, per la navigazione. L'oggetto NavigationRegion3D può avere uno o più figli MeshInstance3D aggiuntivi, che è possibile precalcolare per la navigazione, ma non saranno esportati come mesh visiva.
È riconosciuto solo questo formato specifico. Altri tipi di nodi inseriti come figli non saranno riconosciuti ed esportati. GridMap non è un sistema generico per posizionare di nodi su una griglia, bensì un sistema specifico e ottimizzato, progettato per posizionare mesh con collisioni e navigazione.
Esportare la MeshLibrary
Per esportare la libreria, clicca su Scena > Esporta come... > MeshLibrary... e salvala come risorsa.
È possibile trovare una MeshLibrary già esportata nel progetto, denominata MeshLibrary.tres.
Utilizzo di GridMap
Crea una nuova scena e aggiungi un nodo GridMap. Aggiungi la libreria di mesh trascinando il file risorsa dal pannello Filesystem e rilasciandolo nella proprietà Mesh Library nell'Ispettore.
Proprietà nelll'Ispettore
L'impostazione Physics Material consente di sovrascrivere il materiale fisico per ogni mesh nella NavigationMesh.
Nella sezione Cells, la proprietà Size dovrebbe essere impostata sulla dimensione delle tue mesh. Puoi lasciarla al valore predefinito per la demo. Disabilita la proprietà Center Y.
Le opzioni Collision consentono di impostare lo strato di collisione, la maschera di collisione e la priorità per l'intera griglia. Per ulteriori informazioni su come funzionano, consulta la sezione Fisica.
Nella sezione Navigation è presente l'opzione "Bake Navigation". Se abilitata, crea un'area di navigazione per ogni cella che utilizza un elemento della libreria di mesh con una mesh di navigazione.
Cliccando sulla libreria di mesh stessa nell'ispettore, è possibile regolare le impostazioni delle singole mesh, come la loro mesh di navigazione, gli strati di navigazione o se la mesh proietta ombre.
Pannello GridMap
In basso alll'editor si trova il pannello GridMap, che dovrebbe essersi aperto automaticamente quando hai aggiunto il nodo GridMap.
Da sinistra e destra nella barra degli strumenti:
Transforma: aggiunge un gizmo alla scena che consente di modificare la posizione e rotazione relativa della gridmap nella scena.
Seleziona: mentre è attiva, è possibile selezionare un'area nella viewport; clicca e trascina per selezionare più di uno spazio sulla griglia.
Cancella: mentre è attiva, clicca nella viewport ed elimina le mesh.
Disegna: mentre è attiva, clicca nella viewport e aggiungi alla scena la mesh attualmente selezionata nel pannello GridMap.
Scegli: mentre è attiva, cliccando su una mesh nella gridmap nella viewport, questa verrà selezionata nel pannello GridMap.
Riempi: riempie l'area selezionata nella viewport con la mesh selezionata nel pannello inferiore GridMap.
Sposta: sposta la mesh o le mesh attualmente selezionate nella viewport.
Duplica: crea una copia della mesh o delle mesh selezionate nella GridMap.
Elimina: simile a cancella, ma per l'intera area selezionata.
Ruota cursore in X: mentre lo strumento di disegno è selezionato, questo ruota la mesh che verrà disegnata sull'asse X. Ruota anche le aree selezionate se vengono spostate.
Ruota cursore in Y: mentre lo strumento di disegno è selezionato, questo ruota la mesh che verrà disegnata sull'asse Y. Ruota anche le aree selezionate se vengono spostate.
Ruota cursore in Z: mentre lo strumento di disegno è selezionato, questo ruota la mesh che verrà disegnata sull'asse Z. Ruota anche le aree selezionate se vengono spostate.
Change Grid Floor: regola il piano su cui si sta lavorando attualmente. È possibile cambiarlo con le frecce, digitando un valore nel campo o con Ctrl + rotellina del mouse.
Filter Meshes: serve per cercare una mesh specifica nel pannello inferiore.
Zoom: controlla il livello di zoom sulle mesh nel pannello inferiore.
Opzioni Layout: questi due pulsanti alternano tra diverse disposizioni per le mesh nel pannello inferiore.
Menu a tendina Strumenti: questo pulsante apre un menu a tendina con alcune opzioni in più.
Cliccando su Impostazioni nel menu a tendina si apre una finestra che consente di modificare la Distanza di prelievo, ovvero la distanza massima alla quale è possibile posizionare i tasselli su una gridmap, rispetto alla posizione della telecamera (in metri).
Usare GridMap in codice
Consulta GridMap per i dettagli sui metodi e sulle variabili membro del nodo.