Docs · Extensions · Godot

AI GridMap

Teaches RQL Godot GridMap — validated CellSize / CellOctantSize, cell rows (x y z item orientation) and SetCell / ClearCell / Clear calls; assign the MeshLibrary as a property.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
3 capabilities
Version
1.1.2
Package id
com.IvanMurzak.Godot.MCP.GridMap
Engine
Godot · Godot 4.3+
Wraps
GridMap
Repository

What the agent can do with it

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

  • GridMap settings

    Assign the MeshLibrary and set a validated cell size and octant size (an invalid value fails instead of clamping).

    nodes | where name == "Grid" | set MeshLibrary = "res://tiles.tres", CellSize = "(1, 1, 1)"
  • Paint cells

    Set a cell to a mesh-library item with an orientation (0 to 23), clear one cell, or clear the whole map.

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

    List a GridMap’s filled cells (position, item, item name, orientation) and its cell count.

    nodes | where name == "Grid" | get cells | select x y z item orientation

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.GridMap <GodotProject>

When to ask the AI for it

Ask for modular 3D level layout — lay out a dungeon or building on a GridMap from a mesh library.

Not sure if it's installed? Ask the agent to run rql-schema "GridMap" — 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 GridMap, assign res://dungeon_tiles.tres as its mesh library and place item 0 at cell (2, 0, 3) with orientation 10.
  2. List every filled cell of the GridMap, then clear it.

Keep going