scene-set-active

Sets a specified opened Unity scene as the active scene via unity-mcp-cli.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill scene-set-active-fermisloth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scene-set-active
Source: https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment/tree/main/.agent/skills/scene-set-active
Command: npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill scene-set-active-fermisloth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? When working with multiple opened scenes in the Unity Editor, scripts and editor operations apply to the active scene, so you need a reliable way to switch which scene is active before performing further automation. ## Core Features & Use Cases - Active Scene Switching: Sets any currently opened scene as the active scene using a scene reference (instanceID, asset path, or GUID). - Scene State Output: Returns structured scene data including load state, dirty flag, root count, path, and build index for all opened scenes. - Use Case: While automating a multi-scene Unity workflow, first list opened scenes with the scene-list-opened tool, then set the target scene active before adding or modifying GameObjects in it. ## Quick Start Ask the AI to set the scene at Assets/Scenes/Main.unity as the active scene using the scene-set-active tool.

Frequently Asked Questions about scene-set-active

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

FAQPage Schema
How do I set the active scene in Unity from the command line?

Run unity-mcp-cli run-tool scene-set-active with a JSON input containing a sceneRef that identifies the scene by instanceID, asset path, or GUID. The scene must already be opened in the Unity Editor.

How do I find which scenes are currently opened in Unity?

Use the scene-list-opened tool to get the list of all opened scenes along with their references. Then pass the desired scene reference to scene-set-active to make it active.

What input formats does the scene reference accept?

The sceneRef accepts an instanceID, an assetPath starting with Assets/, or an assetGuid. Providing any of these identifiers lets the tool resolve the corresponding opened scene.

What should I do if unity-mcp-cli is not found?

Install it globally with npm install -g unity-mcp-cli, or invoke it through npx unity-mcp-cli instead. The unity-initial-setup skill contains detailed installation instructions.

Can scene-set-active open a scene that is not currently loaded?

No, this tool only sets an already opened scene as active. To open a new scene from disk, use the appropriate scene-opening tool first, then set it active.