Godot TileMapLayer : définir ensemble l'identité des tuiles, les règles de terrain et les collisions

Séparer la carte des définitions de tuiles

Un TileMapLayer stocke une seule couche de tuiles placées et renvoie à un TileSet qui contient leurs définitions. Utilisez plusieurs nœuds de couche lorsque le niveau exige des éléments superposés : sol, structures ou décor de premier plan. Si plusieurs cartes doivent réutiliser les mêmes définitions de tuiles, enregistrez-les comme ressource externe. Toute modification de cette ressource partagée doit alors être revue partout où elle est utilisée. [1][2]

Choisissez les couches selon la responsabilité d'édition. Pouvoir peindre un toit au premier plan sans remplacer le sol situé en dessous est utile ; créer des couches dont le rôle n'est pas clair rend les modifications ultérieures plus difficiles à comprendre.

Distinguer le placement de l'identité dans l'atlas

Une coordonnée de carte indique où une tuile est placée. Pour une tuile d'atlas, l'identifiant de source, les coordonnées dans l'atlas et l'identifiant d'alternative indiquent quelle définition de tuile y placer. La méthode set_cell les accepte comme paramètres distincts. [1]

Par exemple, une cellule (5, 7) de la carte d'un village peut utiliser l'illustration située à la position (2, 1) de l'atlas. Déplacer cette cellule sur la carte ne signifie pas déplacer l'illustration dans l'atlas. Pour convertir un clic en coordonnées du monde en une cellule, convertissez d'abord la position du clic en coordonnées locales de la couche, puis utilisez local_to_map. Passer directement des coordonnées globales à une conversion qui attend des coordonnées locales peut sélectionner la mauvaise cellule lorsque la couche est transformée. [1]

Préparer les combinaisons de terrain avant de peindre

Les terrains d'un TileSet s'appuient sur des affectations de terrain définies par l'auteur et sur des informations de voisinage (peering) pour choisir les transitions adaptées. Les illustrations et les métadonnées de terrain doivent couvrir les combinaisons dont la carte a besoin. [3]

Imaginez que vous peigniez un chemin de terre dans l'herbe, puis que vous élargissiez un virage. Vérifiez les tronçons droits, les angles intérieurs, les angles extérieurs, les extrémités et les jonctions dont votre mode de terrain a réellement besoin. Si une transition appropriée manque, changer de pinceau ne créera pas l'illustration correspondante. À l'exécution, set_cells_terrain_connect peut en outre modifier les cellules voisines pour connecter le terrain demandé. Son contrat documenté exige que toutes les combinaisons de terrain nécessaires existent pour obtenir un résultat correct. [1]

Définir la collision comme une propriété distincte

Des murs visibles ne sont pas automatiquement solides. Créez la couche de physique concernée dans les définitions de tuiles et affectez des polygones de collision aux tuiles qui doivent bloquer le déplacement. L'éditeur de TileSet permet d'appliquer des propriétés à plusieurs tuiles à la fois, ce qui aide à garder cohérentes les variantes d'un même mur. [3]

Pour le village, examinez les portes et les angles de murs avec les formes de collision affichées. Une couche de toits décoratifs ne doit pas bloquer un passage par inadvertance parce que ses tuiles ont hérité d'une définition de collision inadaptée. Vérifiez à la fois la définition choisie et l'activation de la collision sur la couche. La seule connectivité visuelle des terrains ne suffit pas à établir qu'un passage est praticable en jeu. [1][2]

Tenir compte des mises à jour différées et examiner les cellules voisines

Les mises à jour d'un TileMapLayer sont normalement regroupées en fin de frame. update_internals force une mise à jour anticipée, mais la documentation avertit qu'elle peut être coûteuse. Regroupez les modifications liées et ne demandez une reconstruction immédiate que si une dépendance concrète l'exige. [1]

Examinez une cellule modifiée en même temps que ses voisines, le rendu obtenu et la collision. Rouvrez les cartes après toute modification d'un TileSet partagé, et vérifiez les couches transformées lorsque vous diagnostiquez des erreurs de placement. Ces étapes décrivent une méthode de travail proposée, et non un résultat de performance testé.

Sources

1. TileMapLayer — contributeurs de Godot Engine.
2. Using TileMaps — contributeurs de Godot Engine.
3. Using TileSets — contributeurs de Godot Engine.