Godot TileMapLayer: definir la identidad de los tiles, las reglas de terreno y la colisión en conjunto

Separa el mapa de las definiciones de tiles

Un TileMapLayer almacena una única capa de tiles colocados y hace referencia a un TileSet que contiene sus definiciones. Usa varios nodos de capa cuando el nivel necesite suelo, estructuras o decoración de primer plano superpuestos. Guarda las definiciones de tiles compartidas como un recurso externo cuando varios mapas deban reutilizarlas. Cualquier cambio en ese recurso compartido requiere entonces una revisión en todos los lugares donde se use. [1][2]

Elige las capas según la responsabilidad de edición. Poder pintar un tejado en primer plano sin reemplazar el suelo que hay debajo es útil; crear capas cuya responsabilidad no está clara dificulta entender las ediciones posteriores.

Mantén separadas la posición y la identidad en el atlas

Una coordenada de mapa indica dónde se coloca un tile. En un tile de atlas, el identificador de fuente, las coordenadas del atlas y el identificador de alternativa indican qué definición de tile se coloca ahí. El método set_cell los recibe como parámetros independientes. [1]

Por ejemplo, la celda (5, 7) de un mapa de aldea puede usar el arte situado en la posición (2, 1) del atlas. Mover esa celda del mapa no implica mover el arte dentro del atlas. Al convertir un clic en coordenadas del mundo en una celda, primero convierte la posición del clic a las coordenadas locales de la capa y después usa local_to_map. Pasar coordenadas globales directamente a una conversión en espacio local puede seleccionar una celda equivocada cuando la capa tiene una transformación. [1]

Prepara las combinaciones de terreno antes de pintar

Los terrenos de un TileSet usan asignaciones de terreno definidas por el autor e información de vecindad (peering) para elegir las transiciones adecuadas. El arte y los metadatos de terreno deben cubrir las combinaciones que requiere el mapa. [3]

Imagina que pintas un camino de tierra sobre hierba y luego ensanchas una esquina. Comprueba los tramos rectos, las esquinas interiores, las esquinas exteriores, los extremos y las intersecciones que realmente necesita el modo de terreno elegido. Si falta una transición adecuada, cambiar el pincel no puede crear su arte. En tiempo de ejecución, set_cells_terrain_connect también puede modificar las celdas vecinas para conectar el terreno solicitado. Su contrato documentado exige disponer de todas las combinaciones de terreno necesarias para obtener resultados correctos. [1]

Define la colisión como una propiedad aparte

Las paredes visibles no son sólidas automáticamente. Crea la capa de físicas correspondiente en las definiciones de tiles y asigna polígonos de colisión a los tiles que deban bloquear el movimiento. El editor de TileSet permite aplicar propiedades a varios tiles a la vez, lo que ayuda a mantener coherentes las variantes de pared relacionadas. [3]

En la aldea, revisa las puertas y las esquinas de las paredes con las formas de colisión visibles. Una capa decorativa de tejados no debería bloquear un camino por accidente porque sus tiles heredaron una definición de colisión inadecuada. Comprueba tanto la definición elegida como si la colisión está activada en la capa. La conectividad visual del terreno por sí sola no establece si algo es transitable en el juego. [1][2]

Respeta las actualizaciones diferidas y revisa las celdas vecinas

Las actualizaciones de un TileMapLayer normalmente se agrupan al final del fotograma. update_internals fuerza una actualización anticipada, pero la documentación advierte de que actualizar puede ser costoso. Agrupa las ediciones relacionadas y solicita la reconstrucción inmediata solo cuando una dependencia concreta lo exija. [1]

Revisa una celda modificada junto con sus vecinas, el resultado renderizado y la colisión. Vuelve a abrir los mapas después de editar un TileSet compartido y comprueba las capas transformadas al diagnosticar errores de colocación. Estos pasos describen un flujo de trabajo de edición propuesto, no un resultado de rendimiento probado.

Fuentes

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