uloop-find-game-objects
Find GameObjects with search criteria via uloop CLI. Use when you need to: (1) Locate GameObjects by name pattern, (2) Find objects by tag or layer, (3) Search for objects with specific component types.
When & Why to Use This Skill
The uloop-find-game-objects skill provides a powerful interface for searching and filtering GameObjects within a Unity scene. By leveraging the uloop CLI, it allows developers to quickly locate specific objects based on name patterns, component types, tags, and layers, significantly streamlining scene debugging and hierarchy management workflows.
Use Cases
- 1. Scene Debugging: Quickly locate GameObjects with specific components (e.g., Rigidbody, Collider) to verify their state or configuration.
- 2. Complex Hierarchy Navigation: Find deeply nested objects using regex or path-based search modes, eliminating the need for manual searching in the editor.
- 3. Project Organization Audit: Identify all objects assigned to specific layers or tags to ensure consistency across the project.
- 4. Inactive Object Tracking: Search for and list inactive GameObjects that might be affecting scene logic or memory usage.
| name | uloop-find-game-objects |
|---|---|
| description | "Find specific GameObjects in scene. Use when: searching for objects by name, finding objects with specific components, locating tagged/layered objects, or when user asks to find GameObjects. Returns matching GameObjects with paths and components." |
uloop find-game-objects
Find GameObjects with search criteria.
Usage
uloop find-game-objects [options]
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
--name-pattern |
string | - | Name pattern to search |
--search-mode |
string | Contains |
Search mode: Exact, Path, Regex, Contains |
--required-components |
array | - | Required components |
--tag |
string | - | Tag filter |
--layer |
string | - | Layer filter |
--max-results |
integer | 20 |
Maximum number of results |
--include-inactive |
boolean | false |
Include inactive GameObjects |
Examples
# Find by name
uloop find-game-objects --name-pattern "Player"
# Find with component
uloop find-game-objects --required-components Rigidbody
# Find by tag
uloop find-game-objects --tag "Enemy"
# Regex search
uloop find-game-objects --name-pattern "UI_.*" --search-mode Regex
Output
Returns JSON array of matching GameObjects with paths and components.