BIS fnc taskCreate: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Fix parameter 9 name)
(Added info for task description / CfgTaskDescriptions, reformatted to match BIS_fnc_setTask page)
Line 10: Line 10:
____________________________________________________________________________________________
____________________________________________________________________________________________


| [owner, nameOrParent, details, destination, state, priority, showNotification, type, visibleIn3D] call [[BIS_fnc_taskCreate]] |= Syntax
| [owner, taskID, description, destination, state, priority, showNotification, type, visibleIn3D] call [[BIS_fnc_taskCreate]] |= Syntax


|p1= owner: [[Boolean]], [[Object]], [[Group]], [[Side]] or [[Array]] - Task owner(s) |= Parameter 1
|p1= '''owner''': Task owner(s)
 
<br>[[Boolean]] - true to set task of all playable units
|p2= nameOrParent: [[String]] or [[Array]] - Task name or array in the format [task name, parent task name] |= Parameter 2
<br>[[Object]] - set task of a specific object
 
<br>[[Group]] - set tasks of all objects in the group
|p3= details: [[Array]] or [[String]] - Task description in the format ["description", "title", "marker"] or [[Description.ext#CfgTaskDescriptions|CfgTaskDescriptions]] classname as string |= Parameter 3
<br>[[Side]] - set tasks of all objects of the given side
 
<br>[[Array]] - collection of above types |= Parameter 1
|p4= destination: [[Object]], [[Array]] or [[String]] (default: [[objNull]]) - Task destination (object, position or marker) |= Parameter 4
|p2= '''taskID''':
 
<br>[[String]] - Task ID
|p5= state: [[Boolean]], [[Number]] or [[String]] - Task state (or true to set as current) |= Parameter 5
<br>[[Array]] - In the format of [task ID, parent task ID] |= Parameter 2
 
|p3= '''description''':
|p6= priority: [[Number]] - Task priority (when automatically selecting a new current task, higher priority is selected first) |= Parameter 6
<br>[[Array]] - Task description in the format ["description", "title", "marker"]
 
<br>[[String]] - [[Description.ext#CfgTaskDescriptions|CfgTaskDescriptions]] class name, if empty string is used then [[Description.ext#CfgTaskDescriptions|CfgTaskDescriptions]] is searched for a class matching the tasks TaskID |= Parameter 3
|p7= showNotification: [[Boolean]] (default: true) - Show notification |= Parameter 7
|p4= '''destination''' (Optional): Task destination
 
<br>[[Object]] - Use [[objNull]] to set no position
|p8= type: [[String]] - Task type as defined in the [[Description.ext#CfgTaskTypes| CfgTaskTypes]] |= Parameter 8
<br>[[Array]] - Either position in format [x,y,z], or [object,precision] as used by setSimpleTaskTarget command |= Parameter 4
 
|p5= '''state''' (Optional): Task state
|p9= visibleIn3D: [[Boolean]] - (Optional, default [[false]]) always visible in 3D |= Parameter 9
<br>[[String]] - can be one of following:
<br>"CREATED"
<br>"ASSIGNED"
<br>"AUTOASSIGNED" ("ASSIGNED" when no task is assigned yet, otherwise "CREATED")
<br>"SUCCEEDED"
<br>"FAILED"
<br>"CANCELED"
<br>[[Boolean]] - true to set the task as current |= Parameter 5
|p6= '''priority''' (Optional): [[Number]] - priority. When a current task is completed, system select a next one with the larges priority >{{=}} 0 |= Parameter 6
|p7= '''showNotification''' (Optional): [[Boolean]] - true to show notification (default), false to disable it |= Parameter 7
|p8= '''type''' (Optional): [[String]] - task type from CfgTaskTypes, if not defined, type "" is being used |= Parameter 8
|p9= '''visibleIn3D''' (Optional): [[Boolean]] - true to make task always visible in 3D (default: false) |= Parameter 9


| [[Boolean]] |= Return value
| [[Boolean]] |= Return value

Revision as of 22:13, 19 November 2018

Hover & click on the images for description

Description

Description:
Create a task.
Execution:
call
Groups:
Uncategorised

Syntax

Syntax:
[owner, taskID, description, destination, state, priority, showNotification, type, visibleIn3D] call BIS_fnc_taskCreate
Parameters:
owner: Task owner(s)
Boolean - true to set task of all playable units
Object - set task of a specific object
Group - set tasks of all objects in the group
Side - set tasks of all objects of the given side
Array - collection of above types
taskID:
String - Task ID
Array - In the format of [task ID, parent task ID]
description:
Array - Task description in the format ["description", "title", "marker"]
String - CfgTaskDescriptions class name, if empty string is used then CfgTaskDescriptions is searched for a class matching the tasks TaskID
destination (Optional): Task destination
Object - Use objNull to set no position
Array - Either position in format [x,y,z], or [object,precision] as used by setSimpleTaskTarget command
state (Optional): Task state
String - can be one of following:
"CREATED"
"ASSIGNED"
"AUTOASSIGNED" ("ASSIGNED" when no task is assigned yet, otherwise "CREATED")
"SUCCEEDED"
"FAILED"
"CANCELED"
Boolean - true to set the task as current
priority (Optional): Number - priority. When a current task is completed, system select a next one with the larges priority >= 0
showNotification (Optional): Boolean - true to show notification (default), false to disable it
type (Optional): String - task type from CfgTaskTypes, if not defined, type "" is being used
visibleIn3D (Optional): Boolean - true to make task always visible in 3D (default: false)
Return Value:
Boolean

Examples

Example 1:
[civilian,["task1"],["Do this and you get a cookie","Earn Cookie","cookiemarker"],[0,0,0],1,2,true] call BIS_fnc_taskCreate
Example 2:
[west,["task2"],["Good luck finding this cookie","Find Cookie","cookiemarker2"],objNull,1,3,true] call BIS_fnc_taskCreate //Task without a map location

Additional Information

See also:
BIS_fnc_deleteTaskBIS_fnc_setTaskBIS_fnc_setTaskLocalBIS_fnc_sharedObjectivesBIS_fnc_taskAlwaysVisibleBIS_fnc_taskChildrenBIS_fnc_taskCompletedBIS_fnc_taskCurrentBIS_fnc_taskDescriptionBIS_fnc_taskDestinationBIS_fnc_taskExistsBIS_fnc_taskHintBIS_fnc_taskParentBIS_fnc_taskRealBIS_fnc_taskSetAlwaysVisibleBIS_fnc_taskSetCurrentBIS_fnc_taskSetDescriptionBIS_fnc_taskSetDestinationBIS_fnc_taskSetStateBIS_fnc_taskSetTypeBIS_fnc_taskStateBIS_fnc_tasksUnitBIS_fnc_taskTypeBIS_fnc_taskTypeIconBIS_fnc_taskVarArma 3 Task FrameworkArma 3 Tasks Overhaul

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Bottom Section

Posted on February 2, 2018 - 13:15 (UTC)
Lou Montana
You can define a CfgTaskDescriptions part in description.ext, such as:
class CfgTaskDescriptions
{
	class myTask
	{
		title = $STR_MyTaskTitle;
		description = $STR_MyTaskDescription;
	};
};

This should allow tasks to be localised for every player in MP if created locally. You can use "myTask" as details parameter.