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-inactiveOutput
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