Docs · Extensions · Godot

AI Terrain3D

Adds terrain3d RQL sources — list Terrain3D nodes with region size, data directory, LODs and region count, change the region size, check the addon is installed, and create a Terrain3DMaterial. Requires the Terrain3D addon.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
3 capabilities
Version
1.1.2
Package id
com.IvanMurzak.Godot.MCP.Terrain3D
Engine
Godot · Godot 4.4+
Wraps
Terrain3D (addon)
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with the terrain3d, terrain3d.addon sources and the terrain3d.newMaterial function. That powers 3 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Region size

    Change a terrain’s region size (64, 128, 256, 512, 1024 or 2048; any other size fails and changes nothing).

    terrain3d | where name == "Terrain" | call ChangeRegionSize(1024)
  • Terrain settings

    Create a Terrain3DMaterial and write terrain properties (material, data directory, mesh LODs, vertex spacing) through the row’s node.

    terrain3d | where name == "Terrain" | get node | set props["material"] = terrain3d.newMaterial()
  • Read terrains

    The terrain3d sources: every Terrain3D node with its region size, data directory, LODs and region count, and whether the addon is loaded.

    terrain3d | select name regionSize dataDirectory regionCount version

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

When to ask the AI for it

Ask for open-world ground setup in Godot — add a Terrain3D, set its region size, data directory and material, and inspect its regions.

Not sure if it's installed? Ask the agent to run rql-schema — the terrain3d source only exists when the package is present.

Example prompts

Copy-pasteable first requests. Start with one, verify it in the editor, then build up.

  1. Add a Terrain3D named Terrain, set its region size to 1024 and its data directory to res://terrain_data.
  2. Give the terrain a new Terrain3DMaterial and tell me how many regions it has.

Keep going