// Find GameObjects in the active scene by various criteria. Use when you need to: (1) Search for objects by name, regex, or path, (2) Find objects with specific components, tags, or layers, (3) Get currently selected GameObjects in Unity Editor. Returns matching GameObjects with hierarchy paths and components.
| name | uloop-find-game-objects |
| description | Find GameObjects in the active scene by various criteria. Use when you need to: (1) Search for objects by name, regex, or path, (2) Find objects with specific components, tags, or layers, (3) Get currently selected GameObjects in Unity Editor. Returns matching GameObjects with hierarchy paths and components. |
Find GameObjects with search criteria or get currently selected objects.
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-results | integer | 20 | Maximum number of results |
--include-inactive | boolean | false | Include inactive GameObjects |
--include-inherited-properties | boolean | false | Include inherited properties in results |
| 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 |
| 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) |
# 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
Returns JSON with matching GameObjects.
For Selected mode with multiple objects, results are exported to file:
.uloop/outputs/FindGameObjectsResults/Interact with a local Unity Editor through `unity-ai-cli`. Use when you need to: (1) Discover available Unity tools dynamically, (2) Execute `unity-ai-cli` tools with JSON arguments, (3) Expose the Unity Editor as an MCP server for AI clients.
Clear all Unity Console log entries. Use when you need to: (1) Clear console before running tests or compilation, (2) Start a fresh debugging session, (3) Remove noisy logs to isolate specific output.
Compile Unity project and report errors/warnings. Use when you need to: (1) Verify code compiles after C# file edits, (2) Check for compile errors before testing, (3) Force full recompilation with Domain Reload. Returns error and warning counts.
Control Unity Editor play mode (play/stop/pause). Use when you need to: (1) Start play mode to test game behavior, (2) Stop play mode to return to edit mode, (3) Pause play mode for frame-by-frame inspection.
Execute C# code dynamically in Unity Editor. Use when you need to: (1) Wire prefab/material references and AddComponent operations, (2) Edit SerializedObject properties and reference wiring, (3) Perform scene/hierarchy edits and batch operations. NOT for file I/O or script authoring.
Execute Unity Editor menu commands programmatically. Use when you need to: (1) Trigger menu commands like save, build, or refresh, (2) Automate editor actions via menu paths, (3) Run custom menu items defined in project scripts.