nearEntities

Description

Finds entities inside a sphere with the given radius. If the alternative syntax is used, only entities of given types or subtypes are listed. Entities returned are not sorted by distance.

The main syntax does not return dead entities or entities inside vehicles. If you need to return those, use the alternative syntax (with includeCrew set to true) or the entities command.

Note

This command is much faster than nearestObjects for on-foot soldier and vehicle detection.

Syntax

Syntax 1

position nearEntities radius

Parameters:

• position: Object or PositionAGL or Position2D - search centre
• radius: Number - radius of the sphere

Returns: Array of Objects - not sorted

Syntax 2

position nearEntities [type, radius]

Parameters:

• position: Object or PositionAGL or Position2D - search centre
• type: String or Array of Strings - type(s) to search for. See isKindOf
• radius: Number - radius of the sphere

Returns: Array of Objects - not sorted

Syntax 3

since arma3 2.18

area nearEntities [types, matchExactType, aliveOnly, includeCrew]

Parameters:

• area: String, Object or Array:
  • String - marker name
  • Object - trigger
  • Array - format [center, a, b, angle, isRectangular, c] or Arma 3 v2.22 [center, a, b, angle, isRectangular, c, usePosWorld] (see inArea)
• types: Array of Strings - type(s) to search for or [] empty array to return every type
• matchExactType: Boolean - (Optional, default false) true for an exact type match, false for an isKindOf match
• aliveOnly: Boolean - (Optional, default true) true to ignore dead entities, false to include them
• includeCrew: Boolean - (Optional, default false) true to include crew of vehicles in search

Returns: Array of Objects - not sorted

Examples

Example 1

_list = player nearEntities 20;
_list = ASLToAGL getPosASL player nearEntities 50;
_list = player nearEntities ["Man", 1000];
_list = ASLToAGL getPosASL player nearEntities ["LaserTarget", 3000];
_list = player nearEntities [["Car", "Motorcycle", "Tank"], 50];
_list = ASLToAGL getPosASL player nearEntities [["Man", "Air", "Car", "Motorcycle", "Tank"], 200];

See also

entities · findNearestEnemy · nearestBuilding · nearestObject · nearestObjects · nearObjects · nearestLocation · nearTargets · nearSupplies · nearestLocationWithDubbing · nearObjectsReady · nearRoads · nearestMines