godot-tilemap-mastery

NEVER Do in TileMaps

• NEVER call set_cell() in huge loops without batching — Prefer terrain connect, patterns, or chunk batchers.
• NEVER forget source_id in set_cell — Wrong overload → crash or silent miss.
• NEVER mix world coords with tile coords — Always local_to_map / map_to_local.
• NEVER hand-paint organic blobs when terrains exist — Use terrain sets + set_cells_terrain_connect.
• NEVER put dynamic actors in the TileMap — Enemies/pickups are nodes; tiles are geometry / destructible cells.
• NEVER spam get_cell_tile_data() every physics frame — Cache metadata (fast_metadata_cache.gd).

Decision Tree: How to Write Cells