find_actors
Search actors in Unreal Engine levels by name, label, class, or tag filters. Returns matched counts even when results are truncated.
Instructions
Flexible actor search across the level — combine any number of filters.
Use this to answer "is X in the world", "first 5 actors of class Y", "all actors starting with name Z and tagged W". All filters AND together. Returns total count scanned/matched even when results are truncated.
Args: name_pattern: Case-insensitive substring on UObject name (e.g. "Light"). label_pattern: Case-insensitive substring on outliner display label. class_filter: Class name (short or full path). When it resolves to a real UClass, uses IsA() (or exact_class for ==). Otherwise falls back to substring match on the actor's class name/path. tag: Match actors with this FName in their Tags. exact_class: When class_filter resolves to a UClass, require exact match instead of subclass. max_results: Cap on returned entries (0 = unlimited; truncated flag set). include_transform: Include location/rotation/scale per entry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | ||
| exact_class | No | ||
| max_results | No | ||
| class_filter | No | ||
| name_pattern | No | ||
| label_pattern | No | ||
| include_transform | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |