godot-tilemap-mastery — Claude Code skill for Godot tilemaps

What godot-tilemap-mastery does

This skill covers TileMapLayer and TileSet work in Godot: terrain autotiling, physics layers, per-tile custom data, navigation and runtime edits. A decision table maps a goal to a technique. Organic ground, roads and rivers go through terrain autotile; rooms and prefabs suit TileMapPattern; a handful of precise cells can use plain set_cell; streaming worlds get chunking.

A list of pitfalls comes with it. Dropping source_id from set_cell either crashes or silently misses the cell. World and tile coordinates get mixed up unless you convert with local_to_map and map_to_local. Reading get_cell_tile_data() on every physics tick is replaced by a metadata cache. Enemies and pickups stay nodes; tiles hold geometry and destructible cells.

Bundled scripts handle the heavy cases: procedural chunk batching, world data serialization, destructible tile health, navigation repair after edits, Y-sorting for layers, and a migration helper for projects still on the legacy TileMap. Digging out a tile means the nav mesh and physics shapes need a refresh too, or characters keep walking through the old layout.