Smithery is now a part of Arcade.dev! Read more in our announcement here
Find specific GameObjects in scene...
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.
uloop find-game-objects [options]
| 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 |
| 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 |
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.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.
