unity-plugin

What This Skill Does

The Unity Plugin skill empowers OpenClaw AI agents to interact directly with the Unity Editor, enabling a wide range of game development tasks. It provides access to approximately 100 built-in tools that can be used to manage scenes, manipulate GameObjects and Components, debug issues, simulate user input, and control the Editor's Play mode. This skill is invaluable for automating repetitive tasks, facilitating AI-assisted game design, and enabling remote control of the Unity environment.

It supports two primary connection modes: the OpenClaw Gateway for remote access via platforms like Telegram and Discord, and the MCP Bridge for local connections with AI tools such as Claude Code and Cursor. The gateway connection is designed to auto-connect when Unity opens, while the MCP Bridge requires manual activation within the Unity Editor and offers a default port of 27182. For local AI tools, specific commands are provided to integrate the Unity skill, such as claude mcp add unity --node <path>/MCP~/index.js.

Installation

For initial setup, if the unity_execute tool is not immediately available, you will need to install the gateway extension. This is typically done by navigating to the skill's directory and running the scripts/install-extension.sh script. This script copies essential extension files (like index.ts and package.json) from the skill's extension/ directory to the gateway's extension folder (~/.openclaw/extensions/unity/). After installation, it is crucial to restart the OpenClaw gateway (openclaw gateway restart) for the new extension to be loaded and recognized.

Use Cases

This skill is designed for a variety of Unity development workflows:

• Scene Management: Loading, saving, opening, and inspecting active scenes.
• GameObject Manipulation: Finding, creating, destroying, and querying GameObjects within a scene.
• Component Operations: Getting, setting, adding, and removing components attached to GameObjects.
• Transform Adjustments: Modifying the position, rotation, and scale of GameObjects.
• Debugging and Testing: Taking screenshots, capturing console logs, running tests, and inspecting the hierarchy.
• Input Simulation: Simulating UI clicks, keyboard input, and mouse actions for automated testing or gameplay.
• Editor Control: Controlling Play mode, refreshing the Editor, and getting its current state.
• Asset Management: Finding, copying, moving, and deleting assets. Creating, assigning, and modifying materials. Working with prefabs.
• Package Management: Adding, removing, listing, and searching for Unity packages.

Example Prompts

1. "Show me the hierarchy of the current scene, but only up to depth 2."
2. "Find the GameObject named 'Player', get its Transform component, and set its position to X=0, Y=5, Z=0."
3. "Click on the UI element named 'PlayButton' and then take a screenshot."

Tips & Limitations

Security Note: This skill is configured with disableModelInvocation: true by default. This means the AI cannot automatically invoke tools; it will only execute actions explicitly requested by the user. Refer to README.md for configuration adjustments.

Play Mode: The skill functions effectively in both Editor and Play modes, offering flexibility during development and testing.

Performance: Extensive use of tools that query large amounts of scene data or perform complex manipulations might impact Editor performance. It's advisable to use specific queries where possible.

Error Handling: While the skill provides tools for debugging, complex errors within Unity itself might require manual investigation within the Editor.