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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="com.IvanMurzak.Godot.MCP.GridMap" Version="1.1.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="com.IvanMurzak.Godot.MCP.GridMap" Version="1.1.3" />
                    
Directory.Packages.props
<PackageReference Include="com.IvanMurzak.Godot.MCP.GridMap" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add com.IvanMurzak.Godot.MCP.GridMap --version 1.1.3
                    
#r "nuget: com.IvanMurzak.Godot.MCP.GridMap, 1.1.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package com.IvanMurzak.Godot.MCP.GridMap@1.1.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=com.IvanMurzak.Godot.MCP.GridMap&version=1.1.3
                    
Install as a Cake Addin
#tool nuget:?package=com.IvanMurzak.Godot.MCP.GridMap&version=1.1.3
                    
Install as a Cake Tool

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) and CellOctantSize (at least 1). An invalid value fails the whole mutation and changes nothing (0.x clamped it).
  • Cells: read-only cells rows (x y z item itemName orientation) and cellCount; calls SetCell(x, y, z, item, orientation = 0) (item 0 or more, orientation 0 to 23), ClearCell(x, y, z) and Clear().
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.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.3 57 11/19/2026
1.1.2 331 11/14/2026
1.1.1 390 11/7/2026
1.1.0 174 10/31/2026
1.0.1 152 10/24/2026
1.0.0 171 10/18/2026
0.1.2 154 10/16/2026
0.1.1 159 10/12/2026
0.1.0 477 6/28/2026