Docs · Extensions · Godot

AI CSG

Teaches RQL Godot CSG — validated box / sphere / cylinder / torus dimensions (an invalid value fails instead of clamping) and a rootShape flag; create shapes with the core AddChild and set their boolean Operation.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
2 capabilities
Version
1.1.2
Package id
com.IvanMurzak.Godot.MCP.CSG
Engine
Godot · Godot 4.3+
Wraps
CSG
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with adapters for CSGShape3D, CSGBox3D, CSGSphere3D, CSGCylinder3D, CSGTorus3D. That powers 2 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Shapes & operations

    Set validated box / sphere / cylinder / torus dimensions (an invalid value fails instead of clamping) and each shape’s boolean Operation; create the shapes with the core AddChild.

    nodes | where name == "Ball" | set Radius = 1.8, Operation = "Subtraction"
  • Read CSG shapes

    List every CSG shape with its class, operation and whether it is the root shape that builds the combined mesh.

    nodes | where $ is CSGShape3D | select name class Operation rootShape

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

When to ask the AI for it

Ask for greybox / blockout geometry built from boolean solids without leaving the Godot editor.

Not sure if it's installed? Ask the agent to run rql-schema "CSGShape3D" — the extension's members and methods only appear when the package is present.

Example prompts

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

  1. Create a CSGCombiner3D with a 3×3×3 CSGBox3D and subtract a CSGSphere3D of radius 1.8 from it.
  2. List every CSG shape with its class, operation and whether it is the root shape.

Keep going