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.)