Docs · Extensions · Godot

AI Beehave

Adds a beehave RQL source that lists the scene’s behaviour trees and their nodes with their Beehave classes; build and configure trees with the core AddChild and node property writes. Requires the Beehave addon.

Last updated: 2026-11-15 View as Markdown

At a glance

Capabilities
2 capabilities
Version
1.1.2
Package id
com.IvanMurzak.Godot.MCP.Beehave
Engine
Godot · Godot 4.3+
Wraps
Beehave (addon)
Repository

What the agent can do with it

Adds no MCP tools: it contributes an RQL module with the beehave source. That powers 2 capabilities the agent reaches through rql-query / rql-mutate. How RQL works →

  • Build behaviour trees

    Create a BeehaveTree and its composites, decorators and leaves with the core AddChild (Beehave classes by name), and set tree properties such as the tick rate through the row’s node.

    godot.find("BT") | call AddChild("SelectorComposite", "Sel")
  • Read behaviour trees

    The beehave source: whether the addon is installed, every tree in the scene, and every Beehave node with its class, kind, tree and depth.

    beehave.nodes | where tree == "BT" | select name scriptClass kind depth path

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

When to ask the AI for it

Ask when you want to scaffold or inspect enemy/NPC AI as a Beehave behaviour tree (BeehaveTree, composites, decorators, action/condition leaves).

Not sure if it's installed? Ask the agent to run rql-schema — the beehave 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. Create a BeehaveTree named BT with a SelectorComposite, an InverterDecorator and an ActionLeaf under it, and set its tick rate to 2.
  2. Show every node of the BT behaviour tree with its Beehave class and depth.

Keep going