Godot TileMapLayer

Basic tilemap usage

• Pro-tip: use “Distraction Free Mode” when working with tilemaps so that you can see more! It’s the “expand” icon at the upper right of the editor.
• To set one-way (i.e. directional) collision on a tile map, see these instructions.
• Note: you can only set a collision layer at the level of a whole TileMapLayer, not for individual tiles.

Autotiles and terrains

• See this page for detailed help
• If you need to “expand” your input graphic so that all of the connections are covered (e.g. you only have ~16 tiles and need ~48), you can use Webtyler.
• For SetCellsTerrainConnect or SetCellsTerrainPath
  • Parameters
    • Terrain set
      • 
    • Terrain: get via Godot → TileMapLayer → TileSet (in the Inspector) → Terrain Sets. The order of them there dictates the ID.
      • If you want to use the name from code, I think you would have to read each terrain and then call GetTerrainName and compare against the name that you’re looking for
  • Difference between the two
    • It’s the same as the difference between the terrain and path brushes:
      • 

Bitmask explanation

Remember, they’re not magic! Godot is just connecting shapes that it can match from the bitmasks that you set up. I hastily annotated a small map with red squares to represent the bitmasks:

Suppose we never set up a bitmask for this ”+” shape that you see in the bottom middle:

The map would go from this:

…to this:

(it’s subtle, but you can see the black pixels at the corners of the middle tile have disappeared since Godot no longer found a ”+” connector)

Custom data layers

You can add custom metadata to tilesets (reference). For example, if you have grass, dirt, and stone in your game, you may want to manifest which sounds each tile will play so that you don’t have to do exhaustive checking based on source IDs and tile positions.

It’s very easy to set up by following the documentation.

Troubleshooting

Fading in layered TileMapLayers looks weird

In this screenshot, you can see the green boundary around the stone, but it’s supposed to be the same color as the surrounding tiles.

Here’s what it should look like:

The scene hierarchy is:

• Node2D Root
  • TileMapLayer GreenFill
  • TileMapLayer StoneGround
  • TileMapLayer TreesAndLamps

This technically isn’t even a Godot problem; this is just what happens when you have two overlapping layers fading in from 0 opacity. You essentially need to treat them as one layer, for which you have two options:

• Put the layers into a SubViewport, then make a Sprite2D which uses the SubViewport as a ViewportTexture.
  • Note: anything in the SubViewport needs to have positive coordinates to appear in the sprite’s texture, so you can move the layers positively and the Sprite2D negatively to offset this change.
• Put the layers into a CanvasGroup, which draws everything as a single object.
  • Note: if you do this, you need to modify the CanvasGroup’s self_modulate, not the modulate.
  • Note: it seems like descendants with a different Z-index will not be affected by the CanvasGroup’s self_modulate.