getMissionLayerEntities

Description

Returns all entities within the specific Eden Editor layer and its sub-layers. To be used when the scenario is running, not in the editor workspace. Useful to disable/enable whole parts of the scenario if layers are used during mission design.

Note

Default layers are not returned.

Syntax

getMissionLayerEntities layerName

Parameters:

• layerName: can be one of:
  • String - case-insensitive; layer name in the editor. If multiple layers with the same name are present in the scenario, the first found one is used
  • Number - layer ID in the editor

Returns: Array with [objects, markers, Arma 3 v2.14 groups] (or empty array if the layer does not exist)

Examples

Example 1

private _base = getMissionLayerEntities "Base";

Example 2

delete all objects within that layer after the player is over 800m away from _someObject:

waitUntil { sleep 1; (player distance _someObject) > 800 };
private _simpleObjects = (getMissionLayerEntities "Simple Objects") select 0;
{
    deleteVehicle _x;
} forEach _simpleObjects;

Example 3

private _layer1337Entities = getMissionLayerEntities 1337;

Example 4

getMissionLayerEntities 42 params [["_objects", []], ["_markers", []], ["_groups", []]];

See also

get3DENLayerEntities