gameobject-find

Locate a GameObject in an opened Prefab or active Scene and return its metadata.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locate a specific GameObject by provided information within the opened Prefab or active Scene and return its metadata, including the target's children and a preview of its components.

Core Features & Use Cases

  • Finds the target GameObject in the opened Prefab or active Scene (prefab first if available).
  • Returns GameObject metadata, optional editable data, bounds, hierarchy, and attached components.
  • Supports path-scoped reads via paths or viewQuery to selectively serialize subtrees.

Quick Start

Run the tool with a JSON input that identifies the target GameObject to retrieve its data.

Frequently Asked Questions about gameobject-find

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

FAQPage Schema
How do I find a specific GameObject in a Unity scene or prefab and get its metadata?

You can find a GameObject in Unity by providing its specific reference or path, which locates the target in the opened Prefab or active Scene and returns its metadata. The tool prioritizes the opened Prefab first, then checks the active Scene.

Can I preview attached components on a Unity GameObject without loading the entire scene?

Yes, you can preview attached components on a Unity GameObject by enabling the includeComponents input. This returns an optional components preview alongside the standard GameObject metadata without loading the entire scene hierarchy.

What is the best way to read a specific subtree of a Unity GameObject hierarchy?

The best way to read a specific subtree of a Unity GameObject hierarchy is by using path-scoped reads via the paths or viewQuery inputs. This allows you to selectively serialize subtrees and return only the targeted hierarchy data.

Does the GameObject search tool work with both Unity prefabs and active scenes?

Yes, the GameObject search tool works with both Unity prefabs and active scenes. It automatically prefers the opened Prefab if available, and then falls back to searching the active Scene to retrieve the requested metadata.

What metadata can I retrieve from a Unity GameObject besides its components?

Besides components, you can retrieve optional editable data, bounds, and hierarchy information from a Unity GameObject. By configuring inputs like includeData, includeBounds, and includeHierarchy, you receive a comprehensive GameObjectData structure.

How do I control the depth of the hierarchy when retrieving Unity GameObject data?

You can control the depth of the hierarchy when retrieving Unity GameObject data by specifying the hierarchyDepth input. This limits the returned hierarchy levels within the GameObjectData structure to prevent unnecessarily deep scans.