com.IvanMurzak.Godot.MCP.Tilemap
1.1.3
dotnet add package com.IvanMurzak.Godot.MCP.Tilemap --version 1.1.3
NuGet\Install-Package com.IvanMurzak.Godot.MCP.Tilemap -Version 1.1.3
<PackageReference Include="com.IvanMurzak.Godot.MCP.Tilemap" Version="1.1.3" />
<PackageVersion Include="com.IvanMurzak.Godot.MCP.Tilemap" Version="1.1.3" />
<PackageReference Include="com.IvanMurzak.Godot.MCP.Tilemap" />
paket add com.IvanMurzak.Godot.MCP.Tilemap --version 1.1.3
#r "nuget: com.IvanMurzak.Godot.MCP.Tilemap, 1.1.3"
#:package com.IvanMurzak.Godot.MCP.Tilemap@1.1.3
#addin nuget:?package=com.IvanMurzak.Godot.MCP.Tilemap&version=1.1.3
#tool nuget:?package=com.IvanMurzak.Godot.MCP.Tilemap&version=1.1.3
Tilemap Tools
RQL module for Godot TileMapLayer (4.3+): used-cell rows and SetCell / EraseCell / Clear for the core rql-query / rql-mutate tools, plus an agent guide.
Optional Godot-MCP extension, independently versioned as NuGet package com.IvanMurzak.Godot.MCP.Tilemap.
Requires a Godot C# project (4.3.0+) with a core godot_mcp addon that has the RQL tools
(rql-query / rql-mutate / rql-schema, the release after 0.28.0).
Install
godot-cli install-plugin /path/to/project
godot-cli install-extension com.IvanMurzak.Godot.MCP.Tilemap /path/to/project
godot-cli build /path/to/project
The installer resolves the latest stable version from NuGet; use --version <x.y.z> to request an exact version.
Packages contain C# source and build props, compiled against the project's own GodotSharp.
Previous NuGet versions remain installable after the repository migration.
RQL
Since 1.0.0 the extension is an RQL module: it adds no MCP tools. Agents create TileMapLayers, assign their
TileSet and paint cells with the core rql-query / rql-mutate / rql-schema tools, and the module's guide is
part of the core godot-rql skill. The module adds, on TileMapLayer:
- Cells: read-only
usedCellsrows (x y sourceId atlasX atlasY alternative) andusedCellCount. - Calls:
SetCell(x, y, sourceId, atlasX, atlasY, alternative = 0)(source id, atlas coordinates and alternative validated: 0 or more),EraseCell(x, y)andClear(). A rejected value changes nothing.
root | call AddChild("TileMapLayer", "Layer")
nodes | where name == "Layer" | set TileSet = "res://e2e-tileset.tres"
nodes | where name == "Layer" | call SetCell(0, 0, 0, 0, 0)
nodes | where name == "Layer" | call SetCell(1, 0, 0, 2, 1, 1)
nodes | where name == "Layer" | get usedCells | select x y sourceId atlasX atlasY alternative
nodes | where name == "Layer" | call EraseCell(0, 0)
nodes | where $ is TileMapLayer | select name usedCellCount TileSet
nodes | where name == "Layer" | call Clear()
Every write is one undoable action and marks the scene unsaved (editor | call SaveScene() writes it).
Migrating from 0.x
| 0.x tool | RQL |
|---|---|
tilemap-create |
rql-mutate root \| call AddChild("TileMapLayer", "Layer") |
tilemap-set-tileset |
rql-mutate nodes \| where name == "Layer" \| set TileSet = "res://tiles.tres" |
tilemap-set-cell |
rql-mutate … \| call SetCell(0, 0, 0, 0, 0) (x, y, sourceId, atlasX, atlasY[, alternative]) |
tilemap-erase-cell |
rql-mutate … \| call EraseCell(0, 0) |
tilemap-get-used-cells |
rql-query … \| get usedCells \| select x y sourceId atlasX atlasY; … \| select usedCellCount TileSet |
tilemap-clear |
rql-mutate … \| call Clear() |
Development and releases
See the monorepo test and release guide. This module retains its own package, version, tests and Apache-2.0 license. Releasing another module does not rebuild or republish this package.
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- com.IvanMurzak.McpPlugin (>= 8.25.0)
- com.IvanMurzak.ReflectorNet (>= 5.5.3)
- com.IvanMurzak.Rql (>= 0.5.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.