---
name: "getMissionLayerEntities"
type: command
status: ok
groups: ["Eden Editor", "Mission Information"]
arma3_since: "1.56"
locality: {"argument": null, "effect": null, "server_exec": true}
source: https://community.bistudio.com/wiki/getMissionLayerEntities
revid: 377616
updated: 2026-01-02T08:51:45Z
---

# getMissionLayerEntities

*Command · Eden Editor, Mission Information · Arma 3 v1.56*

Locality: **server execution only**

## 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

```sqf
getMissionLayerEntities layerName
```

**Parameters:**

- `layerName`: can be one of:
  - [String](../topics/String.md) - 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](../topics/Number.md) - layer ID in the editor

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

## Examples

### Example 1

```sqf
private _base = getMissionLayerEntities "Base";
```

### Example 2

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

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

### Example 3

```sqf
private _layer1337Entities = getMissionLayerEntities 1337;
```

### Example 4

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

## See also

[get3DENLayerEntities](../commands/get3DENLayerEntities.md)

## Community notes

**R3vo** — 2016-10-26

After an object was deleted from a layer, [getMissionLayerEntities](../commands/getMissionLayerEntities.md) will return `<NULL-object>` for the deleted object.

<sub>Source: [BI Community Wiki — getMissionLayerEntities](https://community.bistudio.com/wiki/getMissionLayerEntities) (revision 377616).</sub>
