scene-get-data

Retrieves root GameObjects and hierarchy data from a Unity scene.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? When working with Unity scenes through the MCP CLI, you need a structured way to inspect what exists in a scene before modifying it. This Skill retrieves the root GameObjects, hierarchy metadata, bounds, and component data from an opened Unity scene so you can understand its structure programmatically. ## Core Features & Use Cases - Scene Inspection: Fetch the list of root GameObjects from the active scene or a named opened scene. - Configurable Depth: Control hierarchy traversal depth and optionally include bounding boxes and component data. - Structured Output: Returns a typed SceneData JSON object including scene validity, load state, build index, and GameObject references. - Use Case: Before running a GameObject modification tool, call this Skill to enumerate the scene hierarchy and obtain instanceIDs needed as references for subsequent operations. ## Quick Start Ask the AI to list all root GameObjects in the currently active Unity scene including their hierarchy two levels deep.

Frequently Asked Questions about scene-get-data

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

FAQPage Schema
How do I list all GameObjects in a Unity scene from the command line?

Run unity-mcp-cli run-tool scene-get-data with includeRootGameObjects set to true. Set includeChildrenDepth to control how many hierarchy levels are returned in the JSON response.

How to get component data for GameObjects in a Unity scene?

Set the includeData parameter to true when calling scene-get-data. The response then includes shallow component data with instanceID, typeName, and enabled state for each GameObject.

Can I inspect a Unity scene that is not the active scene?

Yes, pass the openedSceneName parameter with the name of any currently opened scene. If omitted or empty, the tool defaults to the active scene.

Why is unity-mcp-cli not found when running scene-get-data?

The CLI is not installed globally. Install it with npm install -g unity-mcp-cli, or prefix commands with npx unity-mcp-cli to run without a global install.

What does scene-get-data return for an invalid scene?

The SceneData result includes an IsValidScene boolean that is false when the scene does not exist or failed to open, along with IsLoaded, IsDirty, and RootCount fields for state verification.