Docs · Extensions · Godot

AI Tilemap

Teaches RQL Godot TileMapLayer — used-cell rows and count, validated SetCell (source id, atlas coords, alternative), EraseCell and Clear; assign the TileSet as a property.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
2 capabilities
Version
1.1.2
Package id
com.IvanMurzak.Godot.MCP.Tilemap
Engine
Godot · Godot 4.3+
Wraps
TileMapLayer
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with adapters for TileMapLayer. That powers 2 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Paint cells

    Set a cell from a tileset source, atlas coordinates and alternative (validated), erase a cell, or clear the layer; assign the TileSet as a property.

    nodes | where name == "Layer" | call SetCell(1, 0, 0, 2, 1)
  • Read cells

    List a TileMapLayer’s used cells (position, source id, atlas coordinates, alternative) and their count.

    nodes | where name == "Layer" | get usedCells | select x y sourceId atlasX atlasY alternative

See it in the Godot catalog →

Install

Requires the base plugin godot_mcp. Then build the project (godot-cli build <GodotProject>); the RQL module loads with the package — the agent sees it in rql-schema.

godot-cligodot-cli install-extension com.IvanMurzak.Godot.MCP.Tilemap <GodotProject>

When to ask the AI for it

Ask for 2D level layout in Godot — paint a ground layer, place tiles, or clear a TileMapLayer.

Not sure if it's installed? Ask the agent to run rql-schema "TileMapLayer" — the extension's members and methods only appear when the package is present.

Example prompts

Copy-pasteable first requests. Start with one, verify it in the editor, then build up.

  1. Create a TileMapLayer, assign res://ground.tres as its tileset and paint atlas tile (2, 1) from source 0 at cell (3, 5).
  2. List every painted cell in the TileMapLayer.

Keep going