Unity Plugin

Unity Plugin Skill

Control Unity Editor through 44 built-in tools. Works in both Editor and Play mode.

Quick Reference

Core Tools

Common Workflows

1. Scene Inspection

unity_execute: debug.hierarchy {depth: 2}
unity_execute: scene.getActive

2. Find & Modify Objects

unity_execute: gameobject.find {name: "Player"}
unity_execute: component.get {objectName: "Player", componentType: "Transform"}
unity_execute: transform.setPosition {objectName: "Player", x: 0, y: 5, z: 0}

3. UI Testing

unity_execute: input.clickUI {name: "PlayButton"}
unity_execute: input.type {text: "TestUser", elementName: "UsernameInput"}
unity_execute: debug.screenshot

4. Play Mode Control

unity_execute: app.play {state: true}   # Enter Play mode
unity_execute: app.play {state: false}  # Exit Play mode
unity_execute: app.getState             # Check current state

5. Force Recompile

unity_execute: editor.refresh           # Refresh assets & recompile
unity_execute: editor.recompile         # Request recompilation only

Tool Categories

Console (2 tools)

• console.getLogs - Get logs with optional type filter (Log/Warning/Error)
• console.clear - Clear captured logs

Scene (4 tools)

• scene.list - List scenes in build settings
• scene.getActive - Get active scene info
• scene.getData - Get full hierarchy data
• scene.load - Load scene by name

GameObject (6 tools)

• gameobject.find - Find by name, tag, or component
• gameobject.create - Create object or primitive (Cube, Sphere, etc.)
• gameobject.destroy - Destroy object
• gameobject.getData - Get detailed data
• gameobject.setActive - Enable/disable
• gameobject.setParent - Change hierarchy

Transform (3 tools)

• transform.setPosition - Set world position {x, y, z}
• transform.setRotation - Set Euler rotation
• transform.setScale - Set local scale

Component (5 tools)

• component.add - Add component by type name
• component.remove - Remove component
• component.get - Get component data/properties
• component.set - Set field/property value
• component.list - List available component types

Script (3 tools)

• script.execute - Execute simple command
• script.read - Read script file
• script.list - List project scripts

Application (3 tools)

• app.getState - Get play mode, FPS, time
• app.play - Enter/exit Play mode
• app.pause - Toggle pause

Debug (3 tools)

• debug.log - Write to console
• debug.screenshot - Capture screenshot
• debug.hierarchy - Text hierarchy view

Editor (4 tools)

• editor.refresh - Refresh AssetDatabase (triggers recompile)
• editor.recompile - Request script recompilation
• editor.focusWindow - Focus window (game/scene/console/hierarchy/project/inspector)
• editor.listWindows - List open windows

Input Simulation (10 tools)

• input.keyPress - Press and release key
• input.keyDown / input.keyUp - Hold/release key
• input.type - Type text into field
• input.mouseMove - Move cursor
• input.mouseClick - Click at position
• input.mouseDrag - Drag operation
• input.mouseScroll - Scroll wheel
• input.getMousePosition - Get cursor position
• input.clickUI - Click UI element by name

Tips

Screenshot Modes

• Play mode: ScreenCapture - includes all UI overlays
• Editor mode: Camera.main.Render() - no overlay UI
• Use {method: "camera"} for camera-only capture

Finding Objects

gameobject.find {name: "Player"}           # By exact name
gameobject.find {tag: "Enemy"}             # By tag
gameobject.find {componentType: "Camera"}  # By component

Script Recompilation

Unity may not auto-recompile after code changes. Use:

editor.refresh    # Full asset refresh + recompile

Play Mode Transitions

• Plugin survives Play mode transitions via SessionState
• If connection lost, wait for auto-reconnect or use Window > OpenClaw Plugin > Force Reconnect

Troubleshooting

Unity Plugin Tools Reference

Complete parameter reference for all 44 tools.

Console Tools

console.getLogs

Get Unity console logs.

{
  "count": 50,           // Max logs to return (default: 50)
  "type": "Error"        // Optional: "Log", "Warning", "Error", "Exception"
}

console.clear

Clear captured logs. No parameters.

---

Scene Tools

scene.list

List all scenes in build settings. No parameters.

scene.getActive

Get active scene info. No parameters. Returns: name, path, buildIndex, isLoaded, rootCount

scene.getData

Get full scene hierarchy.

{
  "depth": 3             // How deep to traverse (default: unlimited)
}

scene.load

Load a scene.

{
  "sceneName": "GameScene",  // Scene name or path
  "additive": false          // Load additively (default: false)
}

---

GameObject Tools

gameobject.find

Find GameObjects.

{
  "name": "Player",          // Find by exact name
  "tag": "Enemy",            // Find by tag
  "componentType": "Camera", // Find by component type
  "includeInactive": false,  // Include inactive objects
  "depth": 1                 // Child depth to return
}

gameobject.create

Create GameObject.

{
  "name": "MyObject",        // Object name
  "primitive": "Cube",       // Optional: Cube, Sphere, Cylinder, Capsule, Plane, Quad
  "parent": "ParentName",    // Optional parent
  "position": {"x": 0, "y": 0, "z": 0}
}

gameobject.destroy

Destroy GameObject.

{
  "name": "ObjectToDestroy"
}

gameobject.getData

Get detailed object data.

{
  "name": "Player",
  "includeComponents": true  // Include component list
}

gameobject.setActive

Enable/disable object.

{
  "name": "Player",
  "active": true
}

gameobject.setParent

Change parent.

{
  "name": "Child",
  "parent": "NewParent",     // null to unparent
  "worldPositionStays": true
}

---

Transform Tools

transform.setPosition

Set world position.

{
  "objectName": "Player",
  "x": 10, "y": 0, "z": 5
}

transform.setRotation

Set rotation (Euler angles).

{
  "objectName": "Player",
  "x": 0, "y": 90, "z": 0
}

transform.setScale

Set local scale.

{
  "objectName": "Player",
  "x": 1, "y": 2, "z": 1
}

---

Component Tools

component.add

Add component to object.

{
  "objectName": "Player",
  "componentType": "Rigidbody"
}

component.remove

Remove component.

{
  "objectName": "Player",
  "componentType": "Rigidbody"
}

component.get

Get component data.

{
  "objectName": "Player",
  "componentType": "Transform"
}

component.set

Set component field/property.

{
  "objectName": "Player",
  "componentType": "Rigidbody",
  "fieldName": "mass",
  "value": 10
}

component.list

List available component types.

{
  "filter": "Collider"       // Optional filter string
}

---

Script Tools

script.execute

Execute simple command.

{
  "command": "Debug.Log(\"Hello\")"
}

script.read

Read script file.

{
  "path": "Assets/Scripts/Player.cs"
}

script.list

List script files.

{
  "folder": "Assets/Scripts",  // Optional folder
  "pattern": "*.cs"            // Optional pattern
}

---

Application Tools

app.getState

Get application state. No parameters. Returns: isPlaying, isPaused, platform, unityVersion, productName, fps, time

app.play

Control Play mode.

{
  "state": true              // true = play, false = stop
}

app.pause

Toggle pause. No parameters.

---

Debug Tools

debug.log

Write to console.

{
  "message": "Test message",
  "type": "Log"              // "Log", "Warning", "Error"
}

debug.screenshot

Capture screenshot.

{
  "method": "screencapture", // "screencapture" or "camera"
  "superSize": 1             // Resolution multiplier
}

debug.hierarchy

Get text hierarchy view.

{
  "depth": 2                 // Max depth
}

---

Editor Tools

editor.refresh

Refresh AssetDatabase (triggers recompile). No parameters.

editor.recompile

Request script recompilation. No parameters.

editor.focusWindow

Focus Editor window.

{
  "window": "game"           // game, scene, console, hierarchy, project, inspector
}

editor.listWindows

List open Editor windows. No parameters.

---

Input Tools

input.keyPress

Press and release key.

{
  "key": "Space"             // Key name (e.g., "A", "Space", "Return", "Escape")
}

input.keyDown

Press and hold key.

{
  "key": "W"
}

input.keyUp

Release key.

{
  "key": "W"
}

input.type

Type text.

{
  "text": "Hello World",
  "elementName": "InputField" // Optional: target input field
}

input.mouseMove

Move mouse.

{
  "x": 500, "y": 300
}

input.mouseClick

Click at position.

{
  "x": 500, "y": 300,
  "button": 0                // 0=left, 1=right, 2=middle
}

input.mouseDrag

Drag operation.

{
  "startX": 100, "startY": 100,
  "endX": 200, "endY": 200,
  "button": 0
}

input.mouseScroll

Scroll wheel.

{
  "delta": 120               // Positive = up, negative = down
}

input.getMousePosition

Get cursor position. No parameters.

input.clickUI

Click UI element by name.

{
  "name": "PlayButton"
}