Godot Tilemap Mastery

Covers the Godot 4.3+ TileMapLayer system with practical scripts for terrain autotiling, destructible tiles, custom data queries, and physics integration. Includes chunking for large worlds, pattern stamping for complex structures, and navigation mesh updates for dynamic environments. The "NEVER do" section is worth reading before you waste time debugging coordinate space mixing or performance tanking from per-frame tile data queries. Best used when you're building grid-based levels and need to go beyond basic tile placement, especially if you're dealing with procedural generation or runtime tile manipulation. The serialization and metadata caching scripts will save you from common performance pitfalls.

skills.sh installs: 277
GitHub stars: 464
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add thedivergentai/gd-agentic-skills --skill godot-tilemap-mastery --agent claude-code

Installs into .claude/skills of the current project.

Files

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).