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.

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.

../../_images/gridmap_meshlibrary1.webp

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.

../../_images/gridmap_create_body.webp

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.

../../_images/gridmap_mesh_scene.webp

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.

../../_images/gridmap_export.webp

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

../../_images/gridmap_mesh_library_inspector.webp

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.

../../_images/gridmap_mesh_library_settings.webp

Pannello GridMap

In basso alll'editor si trova il pannello GridMap, che dovrebbe essersi aperto automaticamente quando hai aggiunto il nodo GridMap.

../../_images/gridmap_panel.webp

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

../../_images/gridmap_dropdown.webp

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.