com.IvanMurzak.Godot.MCP.GridMap
1.1.3
dotnet add package com.IvanMurzak.Godot.MCP.GridMap --version 1.1.3
NuGet\Install-Package com.IvanMurzak.Godot.MCP.GridMap -Version 1.1.3
<PackageReference Include="com.IvanMurzak.Godot.MCP.GridMap" Version="1.1.3" />
<PackageVersion Include="com.IvanMurzak.Godot.MCP.GridMap" Version="1.1.3" />
<PackageReference Include="com.IvanMurzak.Godot.MCP.GridMap" />
paket add com.IvanMurzak.Godot.MCP.GridMap --version 1.1.3
#r "nuget: com.IvanMurzak.Godot.MCP.GridMap, 1.1.3"
#:package com.IvanMurzak.Godot.MCP.GridMap@1.1.3
#addin nuget:?package=com.IvanMurzak.Godot.MCP.GridMap&version=1.1.3
#tool nuget:?package=com.IvanMurzak.Godot.MCP.GridMap&version=1.1.3
GridMap Tools
RQL module for Godot GridMap (3D tile maps): validated settings, cell rows and SetCell / ClearCell / 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.GridMap.
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.GridMap /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 GridMaps, assign their
MeshLibrary 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 GridMap:
- Validated settings:
CellSize(at least 0.001 on every axis) andCellOctantSize(at least 1). An invalid value fails the whole mutation and changes nothing (0.x clamped it). - Cells: read-only
cellsrows (x y z item itemName orientation) andcellCount; callsSetCell(x, y, z, item, orientation = 0)(item 0 or more, orientation 0 to 23),ClearCell(x, y, z)andClear().
root | call AddChild("GridMap", "Grid")
nodes | where name == "Grid" | set MeshLibrary = "res://e2e-meshlib.tres", CellSize = "(1, 1, 1)"
nodes | where name == "Grid" | call SetCell(1, 0, 1, 0)
nodes | where name == "Grid" | call SetCell(2, 0, 1, 0, 10)
nodes | where name == "Grid" | get cells | select x y z item orientation
nodes | where name == "Grid" | call ClearCell(1, 0, 1)
nodes | where $ is GridMap | select name cellCount MeshLibrary
nodes | where name == "Grid" | 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 |
|---|---|
gridmap-defaults |
removed: a new GridMap starts with Godot's defaults; the guide lists typical values |
gridmap-create |
rql-mutate root \| call AddChild("GridMap", "Grid"), then … \| set CellSize = "(1, 1, 1)" |
gridmap-set-mesh-library |
rql-mutate nodes \| where name == "Grid" \| set MeshLibrary = "res://tiles.tres" |
gridmap-set-cell |
rql-mutate … \| call SetCell(1, 0, 1, 0) (orientation as a fifth argument) |
gridmap-clear-cell |
rql-mutate … \| call ClearCell(1, 0, 1) |
gridmap-clear |
rql-mutate … \| call Clear() |
gridmap-get |
rql-query nodes \| where $ is GridMap \| select name CellSize CellScale CellOctantSize MeshLibrary cellCount; … \| get cells |
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.