unity-control-protocol

Automate Unity Editor control via CLI and WebSocket/JSON-RPC 2.0.

25|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/mflRevan/unity-control-protocol --skill unity-control-protocol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-control-protocol
Source: https://github.com/mflRevan/unity-control-protocol/tree/main/website/.generated/skills/unity-control-protocol
Command: npx skills add https://github.com/mflRevan/unity-control-protocol --skill unity-control-protocol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates repetitive and complex tasks within the Unity Editor, enabling programmatic control over scenes, GameObjects, assets, and build pipelines, thereby streamlining development workflows and CI/CD processes.

Core Features & Use Cases

  • Editor Automation: Control Unity Editor features like play mode, scene loading, and script compilation from the command line.
  • Asset & Scene Manipulation: Inspect, modify, and create GameObjects, components, materials, and prefabs.
  • Build & Testing: Automate build pipelines and run Unity tests remotely.
  • Use Case: Automate the process of capturing screenshots of different scenes in your Unity project for documentation or testing purposes.

Quick Start

Use the unity-control-protocol skill to capture a screenshot of the current Unity scene view.

Frequently Asked Questions about unity-control-protocol

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Unity Editor tasks from the command line?

You can automate Unity Editor tasks programmatically using a CLI and bridge package that communicates via WebSocket and JSON-RPC 2.0. This allows you to control scenes, GameObjects, and assets without direct UI interaction.

Can I run Unity build pipelines and tests in a CI/CD environment?

Yes, you can automate Unity build pipelines and run tests remotely in CI/CD environments. The protocol supports triggering builds and executing test suites through command-line interfaces and WebSocket connections.

How does programmatic Unity scene manipulation work without opening the UI?

Programmatic Unity scene manipulation works by sending JSON-RPC 2.0 commands over a WebSocket connection to a bridge package inside the editor. This enables automated inspection, creation, and modification of GameObjects and components.

What is the best way to capture Unity scene screenshots for documentation?

The best way to capture Unity scene screenshots for documentation is by automating the process through CLI commands. This allows you to programmatically load scenes and capture viewport screenshots without manual UI interaction.

Does Unity automation support modifying materials and prefabs remotely?

Yes, Unity automation supports modifying materials and prefabs remotely. The protocol manages assets, components, and prefabs via JSON-RPC 2.0 commands, enabling programmatic creation and inspection of project elements.

What are the limitations of controlling Unity Editor via WebSocket?

The protocol relies on a WebSocket and JSON-RPC 2.0 bridge package inside the Unity Editor, meaning the editor must be running to receive commands. It does not support direct UI interaction but handles scenes, assets, and builds programmatically.