Godot TileMapLayer: Tile-Identität, Terrain-Regeln und Kollision gemeinsam aufbauen

Karte und Tile-Definitionen trennen

Ein TileMapLayer speichert eine einzelne Ebene platzierter Tiles und verweist auf ein TileSet, das deren Definitionen enthält. Mehrere Layer-Nodes bieten sich an, wenn der Level überlappenden Boden, Bauwerke oder Dekoration im Vordergrund benötigt. Gemeinsam genutzte Tile-Definitionen als externe Ressource speichern, wenn mehrere Karten sie wiederverwenden sollen. Eine Änderung an dieser geteilten Ressource muss dann überall geprüft werden, wo sie verwendet wird. [1][2]

Ebenen nach Zuständigkeit beim Bearbeiten wählen. Nützlich ist, ein Dach im Vordergrund malen zu können, ohne den darunterliegenden Boden zu ersetzen; Ebenen mit unklarer Zuständigkeit erschweren dagegen das Nachvollziehen späterer Änderungen.

Platzierung und Atlas-Identität auseinanderhalten

Eine Kartenkoordinate gibt an, wo ein Tile platziert ist. Bei einem Atlas-Tile legen Source-Identifier, Atlas-Koordinaten und Alternative-Identifier fest, welche Tile-Definition dort platziert wird. Die Methode set_cell nimmt diese Angaben als getrennte Eingaben entgegen. [1]

Beispiel: Eine Zelle einer Dorfkarte bei (5, 7) kann Grafik von der Atlas-Position (2, 1) verwenden. Wird diese Kartenzelle verschoben, bedeutet das nicht, dass die Grafik im Atlas verschoben wird. Soll ein Klick im Weltkoordinatensystem in eine Zelle umgerechnet werden, zuerst die Klickposition in lokale Koordinaten des Layers umrechnen und danach local_to_map verwenden. Werden globale Koordinaten direkt in eine Umrechnung für lokale Koordinaten eingespeist, kann bei einem transformierten Layer die falsche Zelle gewählt werden. [1]

Terrain-Kombinationen vor dem Malen vorbereiten

TileSet-Terrains nutzen festgelegte Terrain-Zuweisungen und Peering-Informationen, um passende Übergänge auszuwählen. Grafik und Terrain-Metadaten müssen alle Kombinationen abdecken, die die Karte benötigt. [3]

Als Beispiel: Ein Erdweg wird durch eine Wiese gemalt und an einer Ecke verbreitert. Zu prüfen sind gerade Abschnitte, Innenecken, Aussenecken, Enden und Kreuzungen, die der gewählte Terrain-Modus tatsächlich benötigt. Fehlt ein passender Übergang, lässt sich seine Grafik nicht durch einen anderen Pinsel erzeugen. Zur Laufzeit kann set_cells_terrain_connect zudem benachbarte Zellen ändern, damit das gewünschte Terrain verbunden wird. Laut dokumentiertem Vertrag setzt die Methode für korrekte Ergebnisse alle notwendigen Terrain-Kombinationen voraus. [1]

Kollision als eigene Eigenschaft anlegen

Sichtbare Wände blockieren nicht automatisch. Den passenden Physics Layer in den Tile-Definitionen anlegen und den Tiles, die Bewegung blockieren sollen, Kollisionspolygone zuweisen. Der TileSet-Editor kann Eigenschaften auf mehrere Tiles gleichzeitig anwenden, was dabei hilft, zusammengehörige Wandvarianten konsistent zu halten. [3]

Für das Dorf Türöffnungen und Wandecken bei sichtbaren Kollisionsformen prüfen. Eine dekorative Dachebene sollte nicht versehentlich einen Weg blockieren, weil ihre Tiles eine ungeeignete Kollisionsdefinition geerbt haben. Zu prüfen sind sowohl die gewählte Definition als auch, ob Kollision auf dem Layer aktiviert ist. Die visuelle Terrain-Verbindung allein legt nicht fest, ob etwas im Spiel passierbar ist. [1][2]

Verzögerte Updates beachten und Nachbarzellen prüfen

Updates eines TileMapLayer werden normalerweise gesammelt am Ende des Frames ausgeführt. update_internals erzwingt ein früheres Update, doch die Dokumentation warnt, dass ein solches Update aufwendig sein kann. Zusammengehörige Änderungen bündeln und einen sofortigen Neuaufbau nur anfordern, wenn eine konkrete Abhängigkeit ihn erfordert. [1]

Eine geänderte Zelle zusammen mit ihren Nachbarn, dem gerenderten Ergebnis und der Kollision prüfen. Karten nach Änderungen am geteilten TileSet erneut öffnen und bei der Diagnose von Platzierungsfehlern transformierte Layer kontrollieren. Diese Schritte beschreiben einen vorgeschlagenen Arbeitsablauf beim Erstellen von Karten, kein getestetes Performance-Ergebnis.

Quellen

1. TileMapLayer — Godot Engine contributors.
2. Using TileMaps — Godot Engine contributors.
3. Using TileSets — Godot Engine contributors.