godot-migrate-tilemap

Migrating Godot TileMap to TileMapLayer involves converting legacy 4.0–4.2 nodes into separate 4.3+ layers. This process preserves level data, updates API calls like set_cell, and upgrades TileSet resources while outputting scene updates and backups.

The best way to upgrade multi-layer TileMaps in Godot 4.3 is migrating each legacy layer into a separate TileMapLayer node. This preserves layer order and metadata while modernizing API usage to align with updated terrain and navigation systems.

Yes, Godot 4.3 TileMapLayer migration preserves physics and navigation data. The upgrade transfers associated physics and navigation data per tile and upgrades the TileSet resources to ensure compatibility with the 4.3+ format.

Yes, you can convert set_cell API calls automatically. The migration modernizes legacy API usage by converting set_cell and get_cell calls to TileMapLayer equivalents like set_cells_terrain_connect, aligning with terrain and navigation systems.

A key limitation of migrating TileMap to TileMapLayer is that it requires your project to target Godot 4.3+. The process outputs backups and Git commits for traceability, but you must review generated scene changes and test in Godot 4.3+ afterward.