{"name":"BIS_fnc_strategicMapOpen","operator":null,"title":"BIS fnc strategicMapOpen","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_strategicMapOpen","revid":376191,"updated":"2025-09-14T12:29:08Z","groups":["Strategic"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.00"}],"since":{"game":"arma3","name":"Arma 3","version":"1.00"},"arma3_since":"1.00","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Creates a strategic map.","syntaxes":[{"syntax":"[display, pos, missions, ORBATs, markers, images, weather, night, scale, simulation, label, missionName, missionIcon] call BIS_fnc_strategicMapOpen","since":null,"effect":null,"exec":null,"params":[{"name":"display","type":"Display","optional":false,"default":null,"description":"parent display. When empty, mission display is used.","types":["Display"],"since":null,"text":"display: Display - parent display. When empty, mission display is used."},{"name":"pos","type":"Array format Position","optional":false,"default":null,"description":"default view position in format [x,y,y] or [x,y]","types":["Array","Position"],"since":null,"text":"pos: Array format Position - default view position in format [x,y,y] or [x,y]"},{"name":"missions","type":"Array","optional":false,"default":null,"description":"list of missions, each Array in format:\n- 0: Position - 2D or 3D position of mission\n- 1: Code - Expression executed when user clicks on mission icon\n- 2: String - Mission name\n- 3: String - Short description\n- 4: String - Name of mission's player\n- 5: String - Path to overview image\n- 6: Number - size multiplier for overview image\n- 7: Array - parameters for on-click action. Can be accessed in code with `_this # 9`","types":["Array"],"since":null,"text":"missions: Array - list of missions, each Array in format:\n- 0: Position - 2D or 3D position of mission\n- 1: Code - Expression executed when user clicks on mission icon\n- 2: String - Mission name\n- 3: String - Short description\n- 4: String - Name of mission's player\n- 5: String - Path to overview image\n- 6: Number - size multiplier for overview image\n- 7: Array - parameters for on-click action. Can be accessed in code with `_this # 9`"},{"name":"ORBATs","type":"Array","optional":false,"default":null,"description":"list of ORBAT, each Array in format:\n- 0: Array format Position - 2D or 3D position\n- 1: Config - preview CfgORBAT group\n- 2: Config - topmost displayed CfgORBAT group\n- 3: Array of Strings - list of allowed tags\n- 4: String - name of mission's player\n- 5: Number - maximum number of displayed tiers","types":["Array"],"since":null,"text":"ORBATs: Array - list of ORBAT, each Array in format:\n- 0: Array format Position - 2D or 3D position\n- 1: Config - preview CfgORBAT group\n- 2: Config - topmost displayed CfgORBAT group\n- 3: Array of Strings - list of allowed tags\n- 4: String - name of mission's player\n- 5: Number - maximum number of displayed tiers"},{"name":"markers","type":"Array of Strings","optional":false,"default":null,"description":"list of markers revealed in strategic map (will be hidden when map is closed)","types":["Array","String"],"since":null,"text":"markers: Array of Strings - list of markers revealed in strategic map (will be hidden when map is closed)"},{"name":"images","type":"Array","optional":false,"default":null,"description":"list of custom images, each Array in format:\n- 0: String - texture path\n- 1: Array format Color (RGBA)\n- 2: Array format Position - image position\n- 3: Number - image width in meters\n- 4: Number - image height in meters\n- 5: Number - image angle in degrees\n- 6: String - text displayed next to the image\n- 7: Boolean - true to show shadow","types":["Array"],"since":null,"text":"images: Array - list of custom images, each Array in format:\n- 0: String - texture path\n- 1: Array format Color (RGBA)\n- 2: Array format Position - image position\n- 3: Number - image width in meters\n- 4: Number - image height in meters\n- 5: Number - image angle in degrees\n- 6: String - text displayed next to the image\n- 7: Boolean - true to show shadow"},{"name":"weather","type":"Number","optional":false,"default":null,"description":"overcast, from 0 - 1, where 1 means cloudy weather","types":["Number"],"since":null,"text":"weather: Number - overcast, from 0 - 1, where 1 means cloudy weather"},{"name":"night","type":"Boolean","optional":false,"default":null,"description":"true for night version of strategic map (darker with blue tone)","types":["Boolean"],"since":null,"text":"night: Boolean - true for night version of strategic map (darker with blue tone)"},{"name":"scale","type":"Number","optional":false,"default":null,"description":"default map scale coeficient (1 is automatic scale)","types":["Number"],"since":null,"text":"scale: Number - default map scale coeficient (1 is automatic scale)"},{"name":"simulation","type":"Boolean]","optional":true,"default":"false true to enable simulation while the map is opened","description":null,"types":["Boolean"],"since":null,"text":"simulation: Boolean] - (Optional, default false true to enable simulation while the map is opened"},{"name":"label","type":"String","optional":true,"default":"\"Select a mission\"","description":"bottom bar action label text","types":["String"],"since":null,"text":"label: String - (Optional, default \"Select a mission\") bottom bar action label text"},{"name":"missionName","type":"Boolean","optional":true,"default":"true","description":"true to show icon label as a mission name","types":["Boolean"],"since":null,"text":"missionName: Boolean - (Optional, default true) true to show icon label as a mission name"},{"name":"missionIcon","type":"String","optional":true,"default":"\"\\A3\\Ui_f\\data\\Map\\GroupIcons\\badge_rotate_%1_gs.paa\"","description":"path to mission icon texture\n- %1 - Animation frame from 0-6 (optional)\n- %2 - Index from 1-9 (optional)","types":["String"],"since":null,"text":"missionIcon: String - (Optional, default \"\\A3\\Ui_f\\data\\Map\\GroupIcons\\badge_rotate_%1_gs.paa\") path to mission icon texture\n- %1 - Animation frame from 0-6 (optional)\n- %2 - Index from 1-9 (optional)"}],"returns":{"type":"Display","types":["Display"],"description":"rscDisplayStrategicMap","text":"Display - rscDisplayStrategicMap"}}],"examples":[{"text":"```sqf\n[\n    findDisplay 46,\n    [2000,2000,0],\n    [\n        [\n            [2000,2000,0],\n            {systemChat format [\"%1\",name ((_this # 9) # 0)]},\n            \"1st Mission\",\n            \"This is mission one\",\n            \"Name of mission's player\",\n            \"\\A3\\Data_F_Exp\\Logos\\arma3_exp_icon_ca.paa\",\n            1.5,\n            [player]\n        ],\n        [\n            [1000,1000,0],\n            {systemChat format [\"%1\",name ((_this # 9) # 0)]},\n            \"2nd Mission\",\n            \"This is mission two\",\n            \"Name of mission's player\",\n            \"\\A3\\Data_F_Argo\\Logos\\arma3_argo_logoTitle_ca.paa\",\n            1.5,\n            [player]\n        ]\n    ],\n    [\n        [\n            [3000,3000,0],\n            configFile >> \"CfgORBAT\" >> \"BIS\" >> \"B_1_A_1_2\",\n            configFile >> \"CfgORBAT\" >> \"BIS\" >> \"B_1\",\n            [],\n            10\n        ]\n    ],\n    [\n        \"marker_1\",\n        \"marker_2\"\n    ],\n    [\n        [\n            \"\\A3\\Ui_f\\data\\Logos\\arma3_white_ca.paa\",\n            [0,0,0,1],\n            [4000,4000,0],\n            8,\n            8,\n            0,\n            \"Arma 3 Logo\",\n            true\n        ]\n    ],\n    0,\n    false,\n    1,\n    true,\n    \"Strategic Map Example\",\n    false,\n    \"\\A3\\Ui_f\\data\\Logos\\arma3_white_ca.paa\"\n] call BIS_fnc_strategicMapOpen;\n```","code":["[\n\tfindDisplay 46,\n\t[2000,2000,0],\n\t[\n\t\t[\n\t\t\t[2000,2000,0],\n\t\t\t{systemChat format [\"%1\",name ((_this # 9) # 0)]},\n\t\t\t\"1st Mission\",\n\t\t\t\"This is mission one\",\n\t\t\t\"Name of mission's player\",\n\t\t\t\"\\A3\\Data_F_Exp\\Logos\\arma3_exp_icon_ca.paa\",\n\t\t\t1.5,\n\t\t\t[player]\n\t\t],\n\t\t[\n\t\t\t[1000,1000,0],\n\t\t\t{systemChat format [\"%1\",name ((_this # 9) # 0)]},\n\t\t\t\"2nd Mission\",\n\t\t\t\"This is mission two\",\n\t\t\t\"Name of mission's player\",\n\t\t\t\"\\A3\\Data_F_Argo\\Logos\\arma3_argo_logoTitle_ca.paa\",\n\t\t\t1.5,\n\t\t\t[player]\n\t\t]\n\t],\n\t[\n\t\t[\n\t\t\t[3000,3000,0],\n\t\t\tconfigFile >> \"CfgORBAT\" >> \"BIS\" >> \"B_1_A_1_2\",\n\t\t\tconfigFile >> \"CfgORBAT\" >> \"BIS\" >> \"B_1\",\n\t\t\t[],\n\t\t\t10\n\t\t]\n\t],\n\t[\n\t\t\"marker_1\",\n\t\t\"marker_2\"\n\t],\n\t[\n\t\t[\n\t\t\t\"\\A3\\Ui_f\\data\\Logos\\arma3_white_ca.paa\",\n\t\t\t[0,0,0,1],\n\t\t\t[4000,4000,0],\n\t\t\t8,\n\t\t\t8,\n\t\t\t0,\n\t\t\t\"Arma 3 Logo\",\n\t\t\ttrue\n\t\t]\n\t],\n\t0,\n\tfalse,\n\t1,\n\ttrue,\n\t\"Strategic Map Example\",\n\tfalse,\n\t\"\\A3\\Ui_f\\data\\Logos\\arma3_white_ca.paa\"\n] call BIS_fnc_strategicMapOpen;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["ORBAT Viewer","BIS_fnc_ORBATAddGroupOverlay","BIS_fnc_ORBATAnimate","BIS_fnc_ORBATConfigPreview","BIS_fnc_ORBATGetGroupParams","BIS_fnc_ORBATOpen","BIS_fnc_ORBATRemoveGroupOverlay","BIS_fnc_ORBATSetGroupFade","BIS_fnc_ORBATSetGroupParams","BIS_fnc_ORBATTooltip","BIS_fnc_strategicMapMouseButtonClick","BIS_fnc_strategicMapAnimate"],"notes":[{"user":"ansin11","date":"2021-03-31T15:29:00Z","text":"In order to use an image from the mission folder, the full path to the image has to be provided:\n\n```sqf\n\"images\\MyImage.jpg\" // Does not work\n([str missionConfigFile, 0, -15] call BIS_fnc_trimString) + \"images\\MyImage.jpg\" // works\n\n// edit: since Arma 3 v1.96 getMissionPath is available\ngetMissionPath \"images\\MyImage.jpg\" // works\n```"},{"user":"Hamster2k","date":"2025-09-11T14:34:57Z","text":"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:\n\n```sqf\nwaitUntil { !isNull findDisplay 46 };\n```"},{"user":"Hamster2k","date":"2025-09-12T19:13:07Z","text":"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:\n\n```sqf\nprivate _position = getPosWorld mission1;\n_position2d = [_position select 0, _position select 1];\n_missions pushBack [\n    _position2d,\n    { /*mission code*/ },\n    \"My mission\",\n    \"My mission description\"\n];\n```"}],"categories":["Arma 3: Functions","Arma 3: New Functions","Function Group: Strategic","Functions","Introduced with Arma 3 version 1.00"],"docblock":null,"filled_from_docblock":[]}