CoplayDev/unity-mcp
Unity Mcp
Unity MCP is a plugin that connects the Unity Editor to AI assistants through the Model Context Protocol, enabling natural language control over scene manipulation, object creation, and editor workflows. It allows developers to generate C# scripts, modify GameObjects and components, create UI layouts, and manage assets by issuing commands through an AI interface, effectively turning the editor into a conversational development environment.
The plugin distinguishes itself through a comprehensive automation system that can execute multi-step tasks from a design document, record and replay editor actions, and run headless tests across multiple Unity versions. It provides granular control over AI behavior through configurable execution modes, tool groups, and per-tool toggles, while supporting remote editor control, user session isolation, and API key authentication for secure access. The system also includes semantic validation of generated scripts and the ability to integrate external MCP servers for extended capabilities like 3D model generation.
Beyond core editor control, the plugin offers capabilities for generating 3D assets from text prompts, adapting scene themes, analyzing scenes for optimization, and creating asset variations. It supports multi-instance management for routing calls to specific editor sessions, and provides tools for accessing Unity documentation, explaining concepts, and refining prompts with project context. The configuration surface includes options for choosing AI models, defining custom project rules, and managing API keys directly within the editor interface.
Features
- AI Assistants - Provides an AI assistant that controls the Unity Editor through natural language commands.
- Game Asset Managers - Creates, modifies, and organizes Unity assets through commands issued by an AI assistant.
- Code Generation Assistants - Generates Unity C# scripts from natural language prompts within the editor.
- Natural Language Interface Generators - Interprets structural prompts to create complete UI windows with layout, hierarchy, and components.
- Script Debugging and Repair - Analyzes and repairs Unity scripts by describing issues to an AI assistant that can modify code and components directly.
- Editor Remote Control - Controls the Unity Editor remotely from an MCP client for asset management and script editing.
- Intent-Based Script Generation - Generates Unity scripts from natural language prompts tailored to the project's needs.
- Scene Object Manipulators - Creates, positions, and configures GameObjects, components, materials, and UI elements through AI-driven commands.
- API Key Authentication - Provides the API key needed to authenticate requests to an AI provider for editor interactions.
- MCP Server Connections - Configures additional Model Context Protocol servers to extend the AI's capabilities, such as connecting to a 3D modeling tool.
- Action Approval Gates - Pauses AI-generated changes every 20 actions to request user approval before continuing, ensuring user oversight.
- Context Scope Selectors - Selects which project information the AI assistant can access, such as file structure, scene data, or Git history.
- AI Code Reviewers - Ships an AI code reviewer that analyzes and provides feedback on Unity scripts.
- AI Model Configurations - Selects the underlying AI model from providers like OpenAI or Anthropic to optimize performance for specific Unity development tasks.
- On-Demand Documentation Providers - Provides the AI with local or web-retrieved documentation for unfamiliar frameworks so it can consult them during tasks.
- External Tool Integration - Connects to external MCP servers to extend AI capabilities beyond Unity development.
- Project Context Rules - Creates specialized instructions saved to a project file that the AI reads as additional context before taking any action.
- 3D Scene Generators - Produces complete 3D scenes, including objects, materials, and layout, from a text description using AI.
- 3D Asset Generators - Creates 3D models, scenes, and materials by interpreting natural language descriptions through the Model Context Protocol.
- Generative 3D Modeling - Creates unique game-ready 3D models using AI services and integrates them into existing scenes.
- Tool Group Configurators - Exposes a built-in meta-tool that an AI assistant can call to list, activate, deactivate, or reset tool groups.
- Programmatic Script Editors - Modifies C# scripts in the Unity Editor using instructions from an MCP client.
- Editor Setting Toggles - Provides per-tool toggle switches in the editor interface for granular control over AI capabilities.
- Semantic Analyzers - Performs complete semantic validation of generated C# scripts, catching undefined namespaces, types, and methods before compilation.
- Mode Switchers - Provides a mode switcher that changes how the AI executes tasks, from automatic to recording or plan-following.
- Autonomous Request Limiters - Activates AI-powered code completion as you type and controls how many autonomous requests are made before confirmation.
- Plan-Driven Task Executors - Reads tasks from a design document and executes them to autonomously build a game project.
- Unity Q&A Assistants - Provides an AI assistant that answers Unity-specific questions within the editor.
- UI Event Wiring - Provides a tool to wire UI element events to C# script methods within the Unity Editor.
- In-Editor Key Entry - Lets users enter an API key in the Unity Editor window to connect to a remote-hosted server.
- Access Authentication - Validates API keys against an external endpoint to restrict server access to authorized users only.
- Cross-Version Testing - Runs the package's test suite against multiple Unity editor versions in parallel to catch version-specific breaks.
- Execution Modes - Selects one of six operational modes that control the AI's speed, safety, automation depth, and interaction style for a given task.
- Headless Editor Testing - Boots a headless Unity Editor and executes smoke, EditMode, and PlayMode tests.
- Style Replication from Prefabs - Analyzes a referenced prefab's visual properties and replicates its styles in new UI elements.
