scene-get-data

Retrieves root GameObjects and hierarchy data from a Unity scene.

Updated May 28, 2026
One-click install
npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill scene-get-data-ishaansingh-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: scene-get-data
Source: https://github.com/ishaansingh-ai/Mechanical-2D/tree/main/.claude/skills/scene-get-data
Command: npx skills add https://github.com/ishaansingh-ai/Mechanical-2D --skill scene-get-data-ishaansingh-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Inspecting a Unity scene's structure from outside the editor requires manual navigation of the hierarchy window. This Skill programmatically retrieves the root GameObjects, hierarchy metadata, bounds, and component data from any opened Unity scene via the unity-mcp-cli. ## Core Features & Use Cases - Scene Hierarchy Retrieval: Fetches root GameObjects with configurable children depth to map the full scene structure. - Optional Data Enrichment: Includes bounding boxes, component data, and GameObject metadata (tags, active state, instance IDs) on demand. - Use Case: Before modifying a scene with automation, call this tool to enumerate all root GameObjects in the active scene, then use the returned instanceIDs and paths to target specific objects for editing. ## 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 get the list of GameObjects in a Unity scene?▼

Run the scene-get-data tool via unity-mcp-cli with includeRootGameObjects set to true. It returns root GameObjects with hierarchy metadata, and you can control traversal depth using the includeChildrenDepth parameter.

How to inspect a Unity scene hierarchy from the command line?▼

Use unity-mcp-cli run-tool scene-get-data with a JSON input specifying the opened scene name. The tool returns structured SceneData including root GameObjects, paths, tags, and active states without opening the Unity editor UI.

Can I get component data for GameObjects in a Unity scene?▼

Yes, set includeData to true in the input JSON. The response includes shallow component data for each GameObject, such as component type names, instance IDs, and enabled states, though modification requires a separate component tool.

What happens if I don't specify a scene name in scene-get-data?▼

If openedSceneName is empty or null, the tool defaults to the currently active scene in the Unity editor. Use the scene-list-opened tool first to discover the names of all opened scenes.

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

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