{"name":"BIS_fnc_taskSetDestination","operator":null,"title":"BIS fnc taskSetDestination","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_taskSetDestination","revid":347338,"updated":"2023-09-11T00:28:50Z","groups":["Tasks"],"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":"global","effect":"global","server_exec":false},"exec":null,"description":"Set a task's destination. \n\n> [!NOTE]\n> See Arma 3: Task Framework for more information.","syntaxes":[{"syntax":"[taskName, destination] call BIS_fnc_taskSetDestination","since":null,"effect":null,"exec":null,"params":[{"name":"taskName","type":"String","optional":false,"default":null,"description":null,"types":["String"],"since":null,"text":"taskName: String"},{"name":"destination","type":"Object, Array, Position or String","optional":false,"default":null,"description":"task destination:\n- Object - task will be displayed on the object if player knows about it, otherwise it will be on estimated position or even hidden\n- Array format [object, forceRealPosition]:\n  - object: Object - same as above\n  - forceRealPosition: Boolean - whether or not the task will be on exact object position even if the player does not know about the object\n- Position - task will be on given positon\n- String - marker name. Task will be at markers current position (Won't update if marker was moved)","types":["Object","Array","Position","String"],"since":null,"text":"destination: Object, Array, Position or String - task destination:\n- Object - task will be displayed on the object if player knows about it, otherwise it will be on estimated position or even hidden\n- Array format [object, forceRealPosition]:\n  - object: Object - same as above\n  - forceRealPosition: Boolean - whether or not the task will be on exact object position even if the player does not know about the object\n- Position - task will be on given positon\n- String - marker name. Task will be at markers current position (Won't update if marker was moved)"}],"returns":{"type":"String","types":["String"],"description":"task ID","text":"String - task ID"}}],"examples":[{"text":"```sqf\n[\"BIS_task_01\", [1337, 1337, 0]] call BIS_fnc_taskSetDestination;\n```","code":["[\"BIS_task_01\", [1337, 1337, 0]] call BIS_fnc_taskSetDestination;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["Arma 3: Task Framework"],"notes":[],"categories":["Arma 3: Functions","Arma 3: New Functions","Function Group: Tasks","Functions","Functions: Global Effect","Introduced with Arma 3 version 1.00"],"docblock":null,"filled_from_docblock":[]}