Skip to content
2.0Product documentation

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 nodeWhat it tests
Find ActorsQuery filters, uniqueness, and the context world.
Find Actors in RadiusActor origins inside or on a sphere; no collision required.
Find Actors in BoxActor origins inside an axis-aligned box. Extent is half-size.
Find Actors Around ActorRadius around a reference actor's location and world.
Find Nearest ActorNearest origin within Max Distance.
Overlap Actors in RadiusCollision geometry overlapping a sphere.
Overlap Actors in BoxCollision geometry overlapping an oriented box.
Trace Actors Along LineCollision 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.

Multiple products. One knowledge base.