scene-get-data

Extract root GameObjects from Unity scenes with path-scoped reads or viewQuery.

3.8k|349|Updated Apr 2, 2025
One-click install
npx skills add https://github.com/IvanMurzak/Unity-MCP --skill scene-get-data-ivanmurzak
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scene-get-data
Source: https://github.com/IvanMurzak/Unity-MCP/tree/main/Unity-MCP-Plugin/.claude/skills/scene-get-data
Command: npx skills add https://github.com/IvanMurzak/Unity-MCP --skill scene-get-data-ivanmurzak

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This tool retrieves the list of root GameObjects in the specified scene and supports reading specific fields via path or viewQuery, enabling precise data inspection for debugging and tooling.

Core Features & Use Cases

  • Enumerates root GameObjects in a scene and exposes their basic metadata (name, hierarchy, and optional data) for quick inspection.
  • Supports path-scoped reads and view-query filtering to selectively serialize fields from root GameObjects, reducing data transfer and improving performance.
  • Handles a range of inputs including openedSceneName, includeRootGameObjects, includeChildrenDepth, includeBounds, includeData, and mutually exclusive paths or viewQuery, returning a SceneData structure for downstream tooling.

Quick Start

Run the unity-mcp-cli command to get the root GameObjects of the active or a named scene, optionally filtering with paths or a viewQuery.

Frequently Asked Questions about scene-get-data

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

FAQPage Schema
How do I extract root GameObjects from a Unity scene for debugging?

You can extract root GameObjects by specifying the openedSceneName and using parameters like includeRootGameObjects. The tool selectively reads fields via paths or viewQuery, returning a structured SceneData object for debugging and tooling.

Can I selectively read specific fields from Unity scene hierarchy to reduce data transfer?

Yes, applying path-scoped reads or viewQuery filters fields from the Unity scene's root GameObjects. This selective serialization minimizes data payload and improves retrieval performance during debugging.

What parameters are available when retrieving scene data in Unity?

The tool supports openedSceneName, includeRootGameObjects, includeChildrenDepth, includeBounds, and includeData parameters. It also accepts mutually exclusive 'paths' or 'viewQuery' inputs to filter the extracted SceneData structure.

How do I get the hierarchy of children from Unity root GameObjects?

Use the includeChildrenDepth parameter when extracting root GameObjects to specify how deep the hierarchy serialization goes. This returns a SceneData structure containing the nested objects within the Unity scene.

Does this Unity scene data extraction tool require any external dependencies?

This Unity scene data extraction tool has no external dependencies. It directly reads root GameObjects and returns a SceneData structure using built-in path or viewQuery inputs without requiring additional packages.

When should I use path-scoped reads versus viewQuery to extract Unity scene data?

Path-scoped reads target specific GameObject routes, while viewQuery filters fields dynamically across root GameObjects. These mutually exclusive inputs ensure precise data retrieval, returning a SceneData structure for downstream tooling.