Description
Note
Arma 3: Internally used .fsm.
Compiled FSM that creates a predefined task for the player or changes its state. The only defined task type is "ATTACK"; its task ID is "ATTACK_" followed by the given number.
- If the task does not exist yet, it is created with BIS_fnc_taskCreate (title "Attack name", description "Attack the location and neutralize all enemies.").
- If the task exists and its state is "Assigned" or "Created", its state is changed with BIS_fnc_taskSetState.
Note
The state check is case-sensitive, while a task created as current is stored as "ASSIGNED"; such a task is therefore not updated by a second call.
Syntax
[taskType, taskNumber, params] call BIS_fnc_basicTask
Parameters:
-
taskType: String - "ATTACK"; any other value logs an error -
taskNumber: Number - (Optional, default 0) number appended to the task ID -
params: Array - (Optional, default[])- when the task does not exist: [position, name, isCurrent]
- position: anything accepted by BIS_fnc_position - (Optional, default
markerPos "BIS_attack") task destination; none is set if the position is [0,0,0] - name: String - (Optional, default "the location") name used in the task title
- isCurrent: Boolean - (Optional, default true) set the task as current
- position: anything accepted by BIS_fnc_position - (Optional, default
- when the task exists: [state]
- state: String - (Optional, default "succeeded") new task state
- when the task does not exist: [position, name, isCurrent]
Returns: Nothing
Examples
Example 1
["ATTACK", 1, [getMarkerPos "target", "Agia Marina"]] call BIS_fnc_basicTask; // creates task "ATTACK_1"
See also
BIS_fnc_taskCreate · BIS_fnc_taskSetState · BIS_fnc_taskExists · BIS_fnc_taskState