{"name":"createMarkerLocal","operator":null,"title":"createMarkerLocal","type":"command","url":"https://community.bistudio.com/wiki/createMarkerLocal","revid":378419,"updated":"2026-04-05T12:27:41Z","groups":["Markers"],"status":"ok","replaced_by":[],"games":[{"game":"arma1","name":"Armed Assault","version":"1.04"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma1","name":"Armed Assault","version":"1.04"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":"local","server_exec":false},"exec":null,"description":"Creates a local marker at the given position - the marker only exists on the machine that created it. The marker name has to be unique, if a marker with the given name exists, the command will be ignored. Use deleteMarkerLocal to delete a local marker.\n\nIf the position is given in 3D format, `z` coordinate is stored with the marker and will be used when marker is passed to commands like createVehicle, createUnit, createAgent, createMine, setVehiclePosition for example. However getMarkerPos and markerPos will always return 0 for `z`.\n\n> [!IMPORTANT]\n> Local markers have their own set of local commands \"xxMarkerxxLocal\" to work with. If you use global marker commands on a local marker, the local marker will become **global**.","syntaxes":[{"syntax":"createMarkerLocal [name, position, channel, creator]","since":null,"effect":null,"exec":null,"params":[{"name":"name","type":"String","optional":false,"default":null,"description":null,"types":["String"],"since":null,"text":"name: String"},{"name":"position","type":"Position2D, PositionAGL or Object","optional":false,"default":null,"description":"object's model centre is used (see getPosWorld)","types":["Position2D","PositionAGL","Object"],"since":null,"text":"position: Position2D, PositionAGL or Object - object's model centre is used (see getPosWorld)"},{"name":"channel","type":"Number","optional":true,"default":null,"description":"The marker side for multiplayer","types":["Number"],"since":"arma3 2.02","text":"channel: Number - (Optional)The marker side for multiplayer"},{"name":"creator","type":"Object","optional":true,"default":null,"description":"The marker creator for multiplayer","types":["Object"],"since":"arma3 2.02","text":"creator: Object - (Optional) The marker creator for multiplayer"}],"returns":{"type":"String","types":["String"],"description":"the marker's name, or an empty string if the marker name is not unique","text":"String - the marker's name, or an empty string if the marker name is not unique"},"form":"unary","operator":null,"left":null,"right":{"text":"[name, position, channel, creator]","types":["Array"]}}],"examples":[{"text":"```sqf\n_marker = createMarkerLocal [\"Marker1\", position player];\n```","code":["_marker = createMarkerLocal [\"Marker1\", position player];"]}],"multiplayer":"createMarkerLocal is local, so it should be used along with the other local commands. For global equivalent use createMarker.","problems":"setMarkerDrawPriority sorts allMapMarkers from least to most priority. Before Arma 3 v2.18 createMarker/createMarkerLocal did **not** care about drawing priority and added the created marker to the end of the array, making it top priority. Running setMarkerDrawPriority again sorted this issue.","aliases":[],"see_also":["allMapMarkers","deleteMarkerLocal","createMarker","setMarkerBrushLocal","setMarkerColorLocal","setMarkerDirLocal","setMarkerPosLocal","setMarkerShapeLocal","setMarkerSizeLocal","setMarkerTextLocal","setMarkerTypeLocal","setMarkerAlphaLocal","BIS_fnc_markerToString","BIS_fnc_stringToMarkerLocal"],"notes":[{"user":"Hoz","date":"2007-01-06T17:21:00Z","text":"To create a marker which is visible on the map you need to define *at least* the following three settings:\n\n```sqf\n_markerstr = createMarkerLocal [\"markername\",[_Xpos,_Ypos]];\n_markerstr setMarkerShapeLocal \"ICON\";\n_markerstr setMarkerTypeLocal \"DOT\";\n```"}],"categories":["ArmA: Armed Assault: New Scripting Commands","ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Markers","Introduced with Armed Assault version 1.04","Scripting Commands","Scripting Commands: Local Effect","Take On Helicopters: Scripting Commands"]}