skills.rest
Fermisloth
FermislothCOMMUNITY
Explore all skills by this author →
GitHub

gameobject-find

Finds GameObjects in the active Unity scene or opened Prefab and returns their data.

1|Updated Apr 1, 2026
Search Tags:#unity#find#scene#hierarchy#prefab#gameobject#unity-mcp
One-click install
npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill gameobject-find-fermisloth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gameobject-find
Source: https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment/tree/main/.agent/skills/gameobject-find
Command: npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill gameobject-find-fermisloth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Locating a specific GameObject inside a large Unity scene or Prefab hierarchy is slow when done manually, especially when you also need its components, bounds, or child structure for automation tasks. ## Core Features & Use Cases - Targeted Lookup: Find a GameObject by instanceID, hierarchy path, name, asset path, or asset GUID, searching the opened Prefab first and falling back to the active scene. - Rich Result Payload: Optionally include editable data (tag, layer), attached component previews, 3D bounds, and hierarchy metadata down to a configurable depth. - Use Case: While building a Unity automation workflow, ask the AI to find the 'Player' GameObject with its components and two levels of children, then use the returned instanceID to drive follow-up modification tools. ## Quick Start Ask the AI to find the GameObject named 'Player' in the current scene and include its components and hierarchy.

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 GameObject in a Unity scene from the command line?▼

Run unity-mcp-cli run-tool gameobject-find with a JSON input containing a gameObjectRef. You can reference the object by instanceID, hierarchy path, or name, and the tool returns its data, components, and children.

How do I search for a GameObject inside an opened Prefab instead of the scene?▼

The tool automatically prioritizes the opened Prefab. If any Prefab is open in the Unity Editor, the search runs only inside that Prefab and ignores the scene; otherwise it searches the active scene.

What reference types can I use to locate a Unity GameObject?▼

You can locate a GameObject by instanceID (highest priority), hierarchy path such as 'character/hand/finger', name, assetPath starting with 'Assets/', or assetGuid. If all are empty, the reference resolves to null.

Why is unity-mcp-cli not found when running the command?▼

The CLI is not installed or not on your PATH. Install it globally with npm install -g unity-mcp-cli, or invoke it through npx unity-mcp-cli, then retry the gameobject-find command.

Can I get the child hierarchy and components of a found GameObject?▼

Yes. Set includeHierarchy to true and control depth with hierarchyDepth, where 0 returns only the target. Set includeComponents to true to receive shallow component data including instanceID, type name, and enabled state.

Related Skills

Explore More Software Engineering Skills→
ishaansingh-aiishaansingh-ai

gameobject-component-add

Adds components to GameObjects in Unity scenes or opened prefabs via unity-mcp-cli.

Community
Basic
ishaansingh-aiishaansingh-ai

object-modify

Modify fields and properties of UnityEngine.Object instances via the unity-mcp-cli tool.

Community
Intermediate
igot-aiigot-ai

gameobject-component-destroy

Destroy specified components from a Unity GameObject via HTTP API.

Official
Intermediate
Unity-UPM-PackagesUnity-UPM-Packages

dev-editor-scripting

Automates Unity Editor tasks with MenuItem tools, Custom Inspectors, and AssetPostprocessor hooks.

Official
Intermediate