uloop-find-game-objects

Find Unity scene GameObjects by name, path, regex, component, tag, or layer.

500|44|Updated Jun 15, 2025
One-click install
npx skills add https://github.com/hatayama/unity-cli-loop --skill uloop-find-game-objects-hatayama
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uloop-find-game-objects
Source: https://github.com/hatayama/unity-cli-loop/tree/main/.agents/skills/uloop-find-game-objects
Command: npx skills add https://github.com/hatayama/unity-cli-loop --skill uloop-find-game-objects-hatayama

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly locating and identifying GameObjects in a Unity project's active scene can be tedious when projects grow large, objects are nested deeply in hierarchies, or you need to filter by components, tags, or layers; this Skill provides targeted search and selection capabilities to reduce manual inspection time.

Core Features & Use Cases

  • Flexible Search Modes: Search by exact name, hierarchy path, regular expression, partial name contains, or retrieve currently selected objects from the Unity Editor.
  • Rich Filters: Filter results by required components, tag, layer number, include inactive objects, and limit the number of returned results.
  • Practical Use Case: Use this Skill to find all enemy prefabs with a Rigidbody component on a specific layer for batch debugging, or to export selected UI elements' hierarchy paths and components when preparing localization or automated tests.

Quick Start

Run the uloop find-game-objects command with appropriate flags (for example name pattern, search mode, component, tag, or layer) to return matching GameObjects in JSON or export results to the .uloop/outputs folder when multiple selections are found.

Frequently Asked Questions about uloop-find-game-objects

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

FAQPage Schema
How do I find GameObjects in a Unity scene by component or tag?

You can find GameObjects in a Unity scene by filtering for required components, tags, or layers. This Skill supports Exact, Path, Regex, Contains, and Selected search modes to return matching objects as structured JSON results.

What is the best way to search for inactive GameObjects in Unity for debugging?

Searching for inactive GameObjects in Unity is supported by applying an inclusion filter during your scene inspection. This allows you to locate nested or disabled objects by name, regex, or component without manual hierarchy traversal.

Can I search Unity scene hierarchies using regular expressions from the CLI?

Yes, you can search Unity scene hierarchies using regular expressions directly from the CLI. The Regex mode matches object names or paths and returns structured JSON or exports results to the outputs folder for downstream processing.

How do I export selected Unity GameObjects and their hierarchy paths for batch edits?

You can export selected Unity GameObjects by using Selected mode to retrieve currently active Editor selections. The Skill outputs structured JSON containing hierarchy paths and component data to the outputs folder for batch edits or automated tests.

Does this Unity scene search tool support filtering by layer number?

Yes, this Unity scene search tool supports filtering by layer number alongside component, tag, and name filters. You can combine these rich filters with result limits to narrow down GameObjects for scene inspection or debugging.

What are the limitations of using regex to find Unity GameObjects in large scenes?

When using regex to find Unity GameObjects, limitations include potential performance delays in large scenes with deeply nested hierarchies. Applying result limits and specific component or layer filters helps constrain the search scope and reduce processing overhead.