FindRandomActor - Game

Member of: Game Script

Finds a random actor within a given radius of a location.

Syntax

Actor Function FindRandomActor(float afX, float afY, float afZ, float afRadius) native global

Parameters

• afX: center of the search, X component
• afY: center of the search, Y component
• afZ: center of the search, Z component
• afRadius: Maximum distance from center to look for an actor

Return Value

A random actor found, none if no actor is within the search position and radius.

Examples

; Find a random actor to 0,0,0, limiting the search to 5 units
Actor randomActor = Game.FindRandomActor(0.0, 0.0, 0.0, 5.0)

Notes

• Can use the position, even without offsets, of an actor as the center of the search, the return value will be a random actor.

See Also

• Game Script
• FindClosestActor - Game
• FindClosestActorFromRef - Game
• FindRandomActorFromRef - Game