---
name: "BIS_fnc_strategicMapOpen"
type: function
status: ok
groups: ["Strategic"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_strategicMapOpen
revid: 376191
updated: 2025-09-14T12:29:08Z
---

# BIS_fnc_strategicMapOpen

*Function · Strategic · Arma 3 v1.00*

## Description

Creates a strategic map.

## Syntax

```sqf
[display, pos, missions, ORBATs, markers, images, weather, night, scale, simulation, label, missionName, missionIcon] call BIS_fnc_strategicMapOpen
```

**Parameters:**

- `display`: [Display](../topics/Display.md) - parent display. When empty, mission display is used.
- `pos`: [Array](../topics/Array.md) format [Position](../topics/Position.md) - default view position in format [x,y,y] or [x,y]
- `missions`: [Array](../topics/Array.md) - list of missions, each [Array](../topics/Array.md) in format:
  - 0: [Position](../topics/Position.md) - 2D or 3D position of mission
  - 1: [Code](../topics/Code.md) - Expression executed when user clicks on mission icon
  - 2: [String](../topics/String.md) - Mission name
  - 3: [String](../topics/String.md) - Short description
  - 4: [String](../topics/String.md) - Name of mission's player
  - 5: [String](../topics/String.md) - Path to overview image
  - 6: [Number](../topics/Number.md) - size multiplier for overview image
  - 7: [Array](../topics/Array.md) - parameters for on-click action. Can be accessed in code with `_this # 9`
- `ORBATs`: [Array](../topics/Array.md) - list of ORBAT, each [Array](../topics/Array.md) in format:
  - 0: [Array](../topics/Array.md) format [Position](../topics/Position.md) - 2D or 3D position
  - 1: [Config](../topics/Config.md) - preview CfgORBAT group
  - 2: [Config](../topics/Config.md) - topmost displayed CfgORBAT group
  - 3: [Array](../topics/Array.md) of [String](../topics/String.md)s - list of allowed tags
  - 4: [String](../topics/String.md) - name of mission's player
  - 5: [Number](../topics/Number.md) - maximum number of displayed tiers
- `markers`: [Array](../topics/Array.md) of [String](../topics/String.md)s - list of markers revealed in strategic map (will be hidden when map is closed)
- `images`: [Array](../topics/Array.md) - list of custom images, each [Array](../topics/Array.md) in format:
  - 0: [String](../topics/String.md) - texture path
  - 1: [Array](../topics/Array.md) format [Color (RGBA)](../topics/Color.md)
  - 2: [Array](../topics/Array.md) format [Position](../topics/Position.md) - image position
  - 3: [Number](../topics/Number.md) - image width in meters
  - 4: [Number](../topics/Number.md) - image height in meters
  - 5: [Number](../topics/Number.md) - image angle in degrees
  - 6: [String](../topics/String.md) - text displayed next to the image
  - 7: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) to show shadow
- `weather`: [Number](../topics/Number.md) - overcast, from 0 - 1, where 1 means cloudy weather
- `night`: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) for night version of strategic map (darker with blue tone)
- `scale`: [Number](../topics/Number.md) - default map scale coeficient (1 is automatic scale)
- `simulation`: [Boolean](../topics/Boolean.md)] - (Optional, default [false](../commands/false.md) [true](../commands/true.md) to enable simulation while the map is opened
- `label`: [String](../topics/String.md) - (Optional, default "Select a mission") bottom bar action label text
- `missionName`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [true](../commands/true.md) to show icon label as a mission name
- `missionIcon`: [String](../topics/String.md) - (Optional, default "\A3\Ui_f\data\Map\GroupIcons\badge_rotate_%1_gs.paa") path to mission icon texture
  - %1 - Animation frame from 0-6 (optional)
  - %2 - Index from 1-9 (optional)

**Returns:** [Display](../topics/Display.md) - rscDisplayStrategicMap

## Examples

### Example 1

```sqf
[
    findDisplay 46,
    [2000,2000,0],
    [
        [
            [2000,2000,0],
            {systemChat format ["%1",name ((_this # 9) # 0)]},
            "1st Mission",
            "This is mission one",
            "Name of mission's player",
            "\A3\Data_F_Exp\Logos\arma3_exp_icon_ca.paa",
            1.5,
            [player]
        ],
        [
            [1000,1000,0],
            {systemChat format ["%1",name ((_this # 9) # 0)]},
            "2nd Mission",
            "This is mission two",
            "Name of mission's player",
            "\A3\Data_F_Argo\Logos\arma3_argo_logoTitle_ca.paa",
            1.5,
            [player]
        ]
    ],
    [
        [
            [3000,3000,0],
            configFile >> "CfgORBAT" >> "BIS" >> "B_1_A_1_2",
            configFile >> "CfgORBAT" >> "BIS" >> "B_1",
            [],
            10
        ]
    ],
    [
        "marker_1",
        "marker_2"
    ],
    [
        [
            "\A3\Ui_f\data\Logos\arma3_white_ca.paa",
            [0,0,0,1],
            [4000,4000,0],
            8,
            8,
            0,
            "Arma 3 Logo",
            true
        ]
    ],
    0,
    false,
    1,
    true,
    "Strategic Map Example",
    false,
    "\A3\Ui_f\data\Logos\arma3_white_ca.paa"
] call BIS_fnc_strategicMapOpen;
```

## See also

ORBAT Viewer · [BIS_fnc_ORBATAddGroupOverlay](../functions/BIS_fnc_ORBATAddGroupOverlay.md) · [BIS_fnc_ORBATAnimate](../functions/BIS_fnc_ORBATAnimate.md) · [BIS_fnc_ORBATConfigPreview](../functions/BIS_fnc_ORBATConfigPreview.md) · [BIS_fnc_ORBATGetGroupParams](../functions/BIS_fnc_ORBATGetGroupParams.md) · [BIS_fnc_ORBATOpen](../functions/BIS_fnc_ORBATOpen.md) · [BIS_fnc_ORBATRemoveGroupOverlay](../functions/BIS_fnc_ORBATRemoveGroupOverlay.md) · [BIS_fnc_ORBATSetGroupFade](../functions/BIS_fnc_ORBATSetGroupFade.md) · [BIS_fnc_ORBATSetGroupParams](../functions/BIS_fnc_ORBATSetGroupParams.md) · [BIS_fnc_ORBATTooltip](../functions/BIS_fnc_ORBATTooltip.md) · [BIS_fnc_strategicMapMouseButtonClick](../functions/BIS_fnc_strategicMapMouseButtonClick.md) · [BIS_fnc_strategicMapAnimate](../functions/BIS_fnc_strategicMapAnimate.md)

## Community notes

**ansin11** — 2021-03-31

In order to use an image from the mission folder, the full path to the image has to be provided:

```sqf
"images\MyImage.jpg" // Does not work
([str missionConfigFile, 0, -15] call BIS_fnc_trimString) + "images\MyImage.jpg" // works

// edit: since Arma 3 v1.96 getMissionPath is available
getMissionPath "images\MyImage.jpg" // works
```

---

**Hamster2k** — 2025-09-11

If you want to show the strategic map at the start of the mission by attaching it to the mission display (findDisplay 46;), the mission display needs to be initialized first. You can wait for initialization like this:

```sqf
waitUntil { !isNull findDisplay 46 };
```

---

**Hamster2k** — 2025-09-12

If you are using 3D positions for the positions in your _missions array, be aware that the clickable size of the mission on the map gets reduced the further away from 0 your z coordinate is, becoming unclickable at some point. Use a 2D position like this to avoid that issue:

```sqf
private _position = getPosWorld mission1;
_position2d = [_position select 0, _position select 1];
_missions pushBack [
    _position2d,
    { /*mission code*/ },
    "My mission",
    "My mission description"
];
```

<sub>Source: [BI Community Wiki — BIS fnc strategicMapOpen](https://community.bistudio.com/wiki/BIS_fnc_strategicMapOpen) (revision 376191).</sub>