Appearance
Actor queries
Actor helpers return registered matching actors from the context's world. They do not discover every actor in the scene. Multiple entries for one actor produce one result, and at least one entry must satisfy the complete query.
Pick the right helper
| Blueprint node | What it tests |
|---|---|
| Find Actors | Query filters, uniqueness, and the context world. |
| Find Actors in Radius | Actor origins inside or on a sphere; no collision required. |
| Find Actors in Box | Actor origins inside an axis-aligned box. Extent is half-size. |
| Find Actors Around Actor | Radius around a reference actor's location and world. |
| Find Nearest Actor | Nearest origin within Max Distance. |
| Overlap Actors in Radius | Collision geometry overlapping a sphere. |
| Overlap Actors in Box | Collision geometry overlapping an oriented box. |
| Trace Actors Along Line | Collision hits through the first blocking hit. |
Distances use Unreal centimeters. Negative/non-finite radii or dimensions return empty results. A zero distance means coincident origins, not unlimited range.
Nearby interactables
Register nearby interactables with key Interact and Allow Many. This C++ fragment searches within 300 cm of an actor method's GetActorLocation():
cpp
#include "AuralisRegisterActorLibrary.h"
FAuralisRegisterQuery Query;
Query.Key = TEXT("Interact");
Query.MaxResults = 1;
const TArray<AActor*> Nearby =
UAuralisRegisterActorLibrary::FindActorsInRadius(
this, GetActorLocation(), 300.0, Query);
AActor* Target = Nearby.IsEmpty() ? nullptr : Nearby[0];The include belongs at file scope; the remaining fragment belongs inside an actor method. Spatial filtering and deduplication happen before Max Results. With the default priority sort, this selects the highest-ranked matching actor within the radius; it does not select the nearest one.
Nearest means distance
Find Nearest Actor chooses by origin distance. It ignores Query.MaxResults; query order breaks equal-distance ties. Its Distance output is -1 when no actor matches. Use Ignore Actor to exclude the querying actor if it is registered.
Find Actors Around Actor excludes its reference by default. Its optional Require Registered Reference flag checks whether the reference has any registration, independently of the result query. A null reference returns no results.
Collision behavior
Overlaps and traces need query collision and the appropriate response to the selected collision channel. They test shapes, not just actor origins. Simple collision is the default; complex tracing depends on the asset's collision support. Optional debug drawing is available in builds that support it.
Line hits use ray-distance order, ignore Query.SortMode, and apply Max Results after registry filtering and uniqueness. Touch-only results are included.
WALLS STILL BLOCK THE RAY
An unregistered blocking actor still stops Trace Actors Along Line. Registered actors behind that blocker are not returned. Use the ignored-actors input only for actors you intentionally want the trace to ignore.
For missing spatial results, check registration/scope first, then world context, dimensions, query filters, and collision settings. See Troubleshooting.