Godot Plugin Skill

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

First-Time Setup

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

Godot Skill

AI Skill Market Insights

Quick Start

Manual Installation

TEAR & SHARE

Tags

Be Part of the 3+ Developer Community

Godot Plugin Skill

First-Time Setup

Restart gateway

Quick Reference

Core Tools

Common Workflows

1. Scene Creation

2. Find & Modify Nodes

3. Game Testing with Input

4. Check Logs

Tool Categories

Console (2 tools)

Scene (5 tools)

Node (6 tools)

Transform (3 tools)

Editor (4 tools)

Debug (3 tools)

Input (7 tools) - For Game Testing

Script (2 tools)

Resource (1 tool)

Supported Keys for Input

Node Types for Creation

Tips

Input Simulation

Finding Nodes

Vector Properties

Console Logs

🔐 Security: Model Invocation Setting

Recommendation: true

Pal MCP Server

using-git-worktrees

finishing-a-development-branch

test-driven-development

Channels

Learn

Compare

Company

Agents

Recommendation: `true`