godot-plugin

Godot Plugin Skill

Control Godot 4.x Editor through 30 built-in tools. Supports 80+ node types.

First-Time Setup

If godot_execute tool is not available, install the gateway extension:

# From skill directory
./scripts/install-extension.sh

# Restart gateway
openclaw gateway restart

The extension files are in extension/ directory.

Quick Reference

Core Tools

Category	Key Tools
Scene	scene.create, scene.getCurrent, scene.open, scene.save
Node	node.find, node.create, node.delete, node.getData
Transform	transform.setPosition, transform.setRotation, transform.setScale
Debug	debug.tree, debug.screenshot, console.getLogs
Input	input.keyPress, input.mouseClick, input.actionPress
Editor	editor.play, editor.stop, editor.getState

Common Workflows

1. Scene Creation

Use godot_execute tool:

• godot_execute(tool="scene.create", parameters={rootType: "Node2D", name: "Level1"})
• godot_execute(tool="node.create", parameters={type: "CharacterBody2D", name: "Player"})
• godot_execute(tool="scene.save")

2. Find & Modify Nodes

• godot_execute(tool="node.find", parameters={name: "Player"})
• godot_execute(tool="node.getData", parameters={path: "Player"})
• godot_execute(tool="transform.setPosition", parameters={path: "Player", x: 100, y: 200})

3. Game Testing with Input

• godot_execute(tool="editor.play")
• godot_execute(tool="input.keyPress", parameters={key: "W"})
• godot_execute(tool="input.actionPress", parameters={action: "jump"})
• godot_execute(tool="debug.screenshot")
• godot_execute(tool="editor.stop")

4. Check Logs

• godot_execute(tool="console.getLogs", parameters={limit: 50})
• godot_execute(tool="console.getLogs", parameters={type: "error", limit: 20})

Tool Categories

Console (2 tools)

• console.getLogs - Get logs from Godot log file {limit: 100, type: "error"|"warning"|""}
• console.clear - Placeholder (logs can't be cleared programmatically)

Scene (5 tools)

• scene.getCurrent - Get current scene info
• scene.list - List all .tscn/.scn files
• scene.open - Open scene by path
• scene.save - Save current scene
• scene.create - Create new scene {rootType: "Node2D"|"Node3D"|"Control", name: "SceneName"}

Node (6 tools)

• node.find - Find by name, type, or group
• node.create - Create node (80+ types: CSGBox3D, MeshInstance3D, ColorRect, etc.)
• node.delete - Delete node by path
• node.getData - Get node info, children, transform
• node.getProperty - Get property value
• node.setProperty - Set property value (Vector2/3 auto-converted)

Transform (3 tools)

• transform.setPosition - Set position {x, y} or {x, y, z}
• transform.setRotation - Set rotation (degrees)
• transform.setScale - Set scale

Editor (4 tools)

• editor.play - Play current or custom scene
• editor.stop - Stop playing
• editor.pause - Toggle pause
• editor.getState - Get playing state, version, project name

Debug (3 tools)

• debug.screenshot - Capture viewport
• debug.tree - Get scene tree as text
• debug.log - Print message

Input (7 tools) - For Game Testing

• input.keyPress - Press and release key {key: "W"}
• input.keyDown - Hold key down
• input.keyUp - Release key
• input.mouseClick - Click at position {x, y, button: "left"|"right"|"middle"}
• input.mouseMove - Move mouse to position {x, y}
• input.actionPress - Press input action {action: "jump"}
• input.actionRelease - Release input action

Script (2 tools)

• script.list - List .gd files
• script.read - Read script content

Resource (1 tool)

• resource.list - List files by extension

Supported Keys for Input

A-Z, 0-9, SPACE, ENTER, ESCAPE, TAB, BACKSPACE, DELETE
UP, DOWN, LEFT, RIGHT
SHIFT, CTRL, ALT
F1-F12

Node Types for Creation

Type	Description
Node2D	2D spatial
Node3D	3D spatial
Sprite2D	2D sprite
CharacterBody2D	2D character
CharacterBody3D	3D character
RigidBody2D/3D	Physics body
Area2D/3D	Trigger area
Camera2D/3D	Camera
Label, Button	UI elements

Tips

Input Simulation

• Only works during Play mode
• Use input.actionPress for mapped actions (from Input Map)
• Use input.keyPress for direct key simulation

Finding Nodes

node.find {name: "Player"}      # By name substring
node.find {type: "Sprite2D"}    # By exact type
node.find {group: "enemies"}    # By group

Vector Properties

node.setProperty auto-converts dictionaries to Vector2/Vector3:

{path: "Cam", property: "zoom", value: {x: 2, y: 2}}  # → Vector2(2, 2)

Console Logs

console.getLogs {limit: 50}           # Last 50 lines
console.getLogs {type: "error"}       # Errors only
console.getLogs {type: "warning"}     # Warnings only

🔐 Security: Model Invocation Setting

When publishing to ClawHub, you can configure disableModelInvocation:

Setting	AI Auto-Invoke	User Explicit Request
false (default)	✅ Allowed	✅ Allowed
true	❌ Blocked	✅ Allowed

Recommendation: true

Reason: During Godot development, it's useful for AI to autonomously perform supporting tasks like checking scene tree, taking screenshots, and inspecting nodes.

When to use true: For sensitive tools (payments, deletions, message sending, etc.)