com.IvanMurzak.Godot.MCP.Navigation 1.1.3

dotnet add package com.IvanMurzak.Godot.MCP.Navigation --version 1.1.3
                    
NuGet\Install-Package com.IvanMurzak.Godot.MCP.Navigation -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.Navigation" 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.Navigation" Version="1.1.3" />
                    
Directory.Packages.props
<PackageReference Include="com.IvanMurzak.Godot.MCP.Navigation" />
                    
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.Navigation --version 1.1.3
                    
#r "nuget: com.IvanMurzak.Godot.MCP.Navigation, 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.Navigation@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.Navigation&version=1.1.3
                    
Install as a Cake Addin
#tool nuget:?package=com.IvanMurzak.Godot.MCP.Navigation&version=1.1.3
                    
Install as a Cake Tool

RQL module for Godot navigation (2D & 3D): validated agent, region and link settings, region Bake() and polygon outlines 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.Navigation. 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.Navigation /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, configure, bake and read navigation nodes 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, for the 2D and 3D nodes:

  • Validated members on NavigationAgent2D/3D: Radius (above 0), PathDesiredDistance, TargetDesiredDistance, MaxSpeed, Height (3D), TimeHorizonAgents, TimeHorizonObstacles (0 or more), AvoidancePriority (0 to 1); on NavigationRegion2D/3D and NavigationLink2D/3D: EnterCost / TravelCost (0 or more). An invalid value fails the whole mutation and changes nothing (0.x clamped it).
  • Bake() on the regions (a synchronous bake of the NavigationMesh / NavigationPolygon, returning the polygon count) and polygonCount; AddOutline(points) / ClearOutlines() and outlineCount on NavigationPolygon.
root | call AddChild("NavigationRegion3D", "NavRegion")
nodes | where name == "NavRegion" | set NavigationMesh = {"$type": "NavigationMesh"}
nodes | where name == "NavRegion" | set NavigationMesh.GeometryParsedGeometryType = "StaticColliders", NavigationMesh.AgentRadius = 0.5
nodes | where name == "NavRegion" | call AddChild("StaticBody3D", "Floor")
nodes | where name == "Floor" | call AddChild("CollisionShape3D", "FloorShape")
nodes | where name == "FloorShape" | set Shape = {"$type": "BoxShape3D", "Size": "(10, 1, 10)"}
nodes | where name == "NavRegion" | call Bake()
nodes | where $ is NavigationRegion3D | select name Enabled polygonCount NavigationMesh
root | call AddChild("NavigationAgent3D", "NavAgent")
nodes | where name == "NavAgent" | set Radius = 0.75, MaxSpeed = 8, PathDesiredDistance = 1, TargetDesiredDistance = 1, AvoidanceEnabled = true
root | call AddChild("NavigationLink3D", "NavLink")
nodes | where name == "NavLink" | set StartPosition = "(0, 0, 0)", EndPosition = "(5, 0, 0)", Bidirectional = true
nodes | where $ is NavigationAgent3D | select name Radius MaxSpeed PathDesiredDistance AvoidanceEnabled

Every write is one undoable action and marks the scene unsaved (editor | call SaveScene() writes it); the polygons a Bake() produces are not undoable (bake again).

Migrating from 0.x

0.x tool RQL
navigation-defaults removed: a new agent starts with Godot's defaults (3D radius 0.5 m, max speed 10 m/s; 2D radius 10 px, max speed 100 px/s); the guide lists them
navigation-region-create rql-mutate root \| call AddChild("NavigationRegion3D", "NavRegion") (or NavigationRegion2D)
navigation-region-set-mesh rql-mutate … \| set NavigationMesh = {"$type": "NavigationMesh"} (2D: NavigationPolygon = {"$type": "NavigationPolygon"}), or a "res://…" path; new: call Bake()
navigation-agent-create rql-mutate root \| call AddChild("NavigationAgent3D", "NavAgent") (or NavigationAgent2D)
navigation-agent-configure rql-mutate nodes \| where name == "NavAgent" \| set Radius = 0.75, MaxSpeed = 8, AvoidanceEnabled = true
navigation-link-create rql-mutate … \| call AddChild("NavigationLink3D", "NavLink"), then set StartPosition = "(0, 0, 0)", EndPosition = "(5, 0, 0)"
navigation-get rql-query nodes \| where $ is NavigationAgent3D \| select name Radius MaxSpeed … (regions: Enabled polygonCount NavigationMesh; links: StartPosition EndPosition Bidirectional)

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 81 11/19/2026
1.1.2 329 11/14/2026
1.1.1 393 11/7/2026
1.1.0 170 10/31/2026
1.0.1 150 10/24/2026
1.0.0 167 10/18/2026
0.1.2 156 10/16/2026
0.1.1 168 10/12/2026
0.1.0 493 6/28/2026