uloop find-game-objects
Find GameObjects with search criteria or get details for currently selected Hierarchy objects.
Use this before execute-dynamic-code when identifying or inspecting selected GameObjects. Use get-hierarchy instead when you need the child tree, parent-child structure, or descendants under the selection.
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-count |
integer |
20 |
Maximum number of results |
--include-inactive |
flag |
- |
Include inactive GameObjects |
--include-inherited-properties |
flag |
- |
Include inherited properties in results |
Search Modes
| Mode |
Description |
exact |
Exact name match (default). Trap: --name-pattern "Camera" will not match a GameObject named "Main Camera" — use contains or regex for partial matching. A zero-hit exact search returns a Message hint pointing this out. |
path |
Hierarchy path search (e.g., Canvas/Button) |
regex |
Regular expression pattern |
contains |
Partial name match |
selected |
Get currently selected GameObjects in Unity Editor |
Output
Returns JSON with:
Results (array): Matching GameObjects, each containing:
Name (string): GameObject namePath (string): Hierarchy path (e.g., Canvas/Panel/Button)IsActive (boolean): Active state in hierarchyTag (string): GameObject tagLayer (number): Layer indexComponents (array): Each entry has Type (short name, e.g., Rigidbody), FullTypeName (e.g., UnityEngine.Rigidbody), and Properties (array of Inspector-visible {Name, Type, Value} pairs)
TotalFound (number): Results returned (after --max-count clipping). For multi-selection file export, this is the number exported.ErrorMessage (string): Top-level failure summary (empty on success)ProcessingErrors (array): Selected-mode per-GameObject serialization failures, each {GameObjectName, GameObjectPath, Error}. Omitted/null or empty on clean runs.
Multi-selection file export
For selected mode with multiple successfully serialized GameObjects, inline Results is not populated and the data is written to a file instead. Two extra fields appear:
ResultsFilePath (string): Relative path under .uloop/outputs/FindGameObjectsResults/Message (string): Human-readable summary (e.g., "5 GameObjects exported")
Single-selection and search-mode calls (exact, path, regex, contains) always return inline. No selection (selected mode with empty selection) returns empty Results plus a Message.
1---2name: uloop-find-game-objects3description: Find or inspect Unity GameObjects, especially objects the user currently selected in the Hierarchy. Use for details, components, tags, layers, or name/path searches.4---56# uloop find-game-objects78Find GameObjects with search criteria or get details for currently selected Hierarchy objects.910Use this before `execute-dynamic-code` when identifying or inspecting selected GameObjects. Use `get-hierarchy` instead when you need the child tree, parent-child structure, or descendants under the selection.1112## Usage1314```bash15uloop find-game-objects [options]16```1718## Parameters1920| Parameter | Type | Default | Description |21|-----------|------|---------|-------------|22| `--name-pattern` | string | - | Name pattern to search |23| `--search-mode` | string | `exact` | Search mode: `exact`, `path`, `regex`, `contains`, `selected` |24| `--required-components` | array | - | Required components |25| `--tag` | string | - | Tag filter |26| `--layer` | integer | - | Layer filter (layer number) |27| `--max-count` | integer | `20` | Maximum number of results |28| `--include-inactive` | flag | - | Include inactive GameObjects |29| `--include-inherited-properties` | flag | - | Include inherited properties in results |3031## Search Modes3233| Mode | Description |34|------|-------------|35| `exact` | Exact name match (default). **Trap**: `--name-pattern "Camera"` will not match a GameObject named `"Main Camera"` — use `contains` or `regex` for partial matching. A zero-hit `exact` search returns a `Message` hint pointing this out. |36| `path` | Hierarchy path search (e.g., `Canvas/Button`) |37| `regex` | Regular expression pattern |38| `contains` | Partial name match |39| `selected` | Get currently selected GameObjects in Unity Editor |4041## Output4243Returns JSON with:4445- `Results` (array): Matching GameObjects, each containing:46 - `Name` (string): GameObject name47 - `Path` (string): Hierarchy path (e.g., `Canvas/Panel/Button`)48 - `IsActive` (boolean): Active state in hierarchy49 - `Tag` (string): GameObject tag50 - `Layer` (number): Layer index51 - `Components` (array): Each entry has `Type` (short name, e.g., `Rigidbody`), `FullTypeName` (e.g., `UnityEngine.Rigidbody`), and `Properties` (array of Inspector-visible `{Name, Type, Value}` pairs)52- `TotalFound` (number): Results returned (after `--max-count` clipping). For multi-selection file export, this is the number exported.53- `ErrorMessage` (string): Top-level failure summary (empty on success)54- `ProcessingErrors` (array): Selected-mode per-GameObject serialization failures, each `{GameObjectName, GameObjectPath, Error}`. Omitted/null or empty on clean runs.5556### Multi-selection file export5758For `selected` mode with **multiple** successfully serialized GameObjects, inline `Results` is not populated and the data is written to a file instead. Two extra fields appear:5960- `ResultsFilePath` (string): Relative path under `.uloop/outputs/FindGameObjectsResults/`61- `Message` (string): Human-readable summary (e.g., "5 GameObjects exported")6263Single-selection and search-mode calls (`exact`, `path`, `regex`, `contains`) always return inline. No selection (`selected` mode with empty selection) returns empty `Results` plus a `Message`.
hatayama