uloop find-game-objects
Find GameObjects with search criteria or get currently selected objects.
Usage
uloop find-game-objects [options]
Parameters
Parameter Type Default Description
--name-pattern
string
Name pattern to search
--search-mode
string Exact
Search mode: Exact , Path , Regex , Contains , Selected
--required-components
array
Required components
--tag
string
Tag filter
--layer
integer
Layer filter (layer number)
--max-results
integer 20
Maximum number of results
--include-inactive
boolean false
Include inactive GameObjects
--include-inherited-properties
boolean false
Include inherited properties in results
Search Modes
Mode Description
Exact
Exact name match (default)
Path
Hierarchy path search (e.g., Canvas/Button )
Regex
Regular expression pattern
Contains
Partial name match
Selected
Get currently selected GameObjects in Unity Editor
Global Options
Option Description
--project-path <path>
Target a specific Unity project (mutually exclusive with --port )
-p, --port <port>
Specify Unity TCP port directly (mutually exclusive with --project-path )
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
Get selected GameObjects
uloop find-game-objects --search-mode Selected
Get selected including inactive
uloop find-game-objects --search-mode Selected --include-inactive
Output
Returns JSON with matching GameObjects.
For Selected mode with multiple objects, results are exported to file:
-
Single selection: JSON response directly
-
Multiple selection: File at .uloop/outputs/FindGameObjectsResults/
-
No selection: Empty results with message