---
name: "buildingPos"
type: command
status: ok
groups: ["Positions"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/buildingPos
revid: 377392
updated: 2026-01-02T06:44:35Z
---

# buildingPos

*Command · Positions · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

Locality: arguments **global**

## Description

Returns position of a given indexed position in a [building](../topics/Object.md#building).

## Syntax

```sqf
building buildingPos index
```

**Parameters:**

- `building`: [Object](../topics/Object.md)
- `index`: [Number](../topics/Number.md) - index of a specific position 

  > [!NOTE]
  > **Arma 3:** Since v1.56 index `-1` will return all available building positions.

**Returns:** [PositionAGL](../topics/Position.md#positionagl) - a single building position. If building position with given index does not exist, `[0, 0, 0]` is returned

> [!NOTE]
> **Arma 3:** Since v1.56 it can also return an [array](../topics/Array.md) of all building positions in format [PositionAGL](../topics/Position.md#positionagl) if index that was given is `-1`.

## Examples

### Example 1

```sqf
_soldier setPosATL (_house1 buildingPos 2);
```

### Example 2

```sqf
_allpositions = nearestBuilding player buildingPos -1;
```

## See also

[nearestBuilding](../commands/nearestBuilding.md) · [nearestObject](../commands/nearestObject.md) · [nearestObjects](../commands/nearestObjects.md) · [nearObjects](../commands/nearObjects.md) · [insideBuilding](../commands/insideBuilding.md) · [buildingExit](../commands/buildingExit.md) · [position](../commands/position.md) · [setPos](../commands/setPos.md) · [setWaypointHousePosition](../commands/setWaypointHousePosition.md) · [waypointHousePosition](../commands/waypointHousePosition.md) · [BIS_fnc_buildingPositions](../functions/BIS_fnc_buildingPositions.md)

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