Base class for all [BehaviorTree] tasks. Base class for all [BehaviorTree] tasks. A task is a basic building block in a [BehaviorTree] that represents a specific behavior or control flow. Tasks are used to create complex behaviors by combining and nesting them in a hierarchy. A task can be one of the following types: action, condition, composite, or decorator. Each type of task has its own corresponding subclass: [BTAction], [BTCondition], [BTDecorator], [BTComposite]. Tasks perform their work and return their status using the [method _tick] method. Status values are defined in [enum BT.Status]. Tasks can be initialized using the [method _setup] method. See also [method _enter] & [method _exit]. [b]Note:[/b] Do not extend [BTTask] directly for your own tasks. Instead, extend one of the subtypes mentioned above. Called when task is "entered", i.e. when task is executed while not having a [code]RUNNING[/code] [member status]. It is called before [method _tick] in the execution order. This method is used when preparation is needed before main work begins, usually when it takes more than one tick to finish the task. See also [method execute]. Called when task is "exited", i.e. after [method _tick] returns [code]SUCCESS[/code] or [code]FAILURE[/code] status. See also [method execute]. Called to generate a display name for the task unless [member custom_name] is set. See [method get_task_name]. The string returned by this method is shown as a warning message in the behavior tree editor. Any task script that overrides this method must include [code]@tool[/code] annotation at the top of the file. Called to initialize a task during initialization step. It is called only once before the task's first execution tick. This method allows you to set up any necessary state or configurations for the task before it begins executing. Called when task is "ticked", i.e. executed by [BTPlayer] or [BTState] during an update. Returns execution status as defined in [enum BT.Status]. [b]Note:[/b] Tasks perform their main function by implementing this method. Resets the task and its children recursively. If a task is in the [code]RUNNING[/code] state, it is exited and its status is reset to [code]FRESH[/code]. Adds a child task. The [param task] is placed at the end of the children list. Adds a child task. The [param task] is placed at [param idx] position in the children list. Duplicates the task and its children, copying the exported members. Sub-resources are shared for efficiency, except for [BBParam] subtypes, which are always copied. Used by the editor to instantiate [BehaviorTree] and copy-paste tasks. Returns the behavior tree that owns this task. This is only available in the editor. Performs task's execution. The execution follows a specific sequence: - If task's current [member status] is not [code]RUNNING[/code], the [method _enter] method is called first. - Next, the [method _tick] method is called next to perform the task's work. - If the [method _tick] method returns [code]SUCCESS[/code] or [code]FAILURE[/code] status, the [method _exit] method will be called next as part of the execution cleanup. Returns a child task by specifying its index. Returns the number of child tasks. Returns the number of child tasks not counting [BTComment] tasks. Returns the task's position in the behavior tree branch. Returns [code]-1[/code] if the task doesn't belong to a task tree, i.e. doesn't have a parent. Returns the task's parent. Returns the root task of the behavior tree. The string returned by this method is used to represent the task in the editor. Method [method _generate_name] is called to generate a display name for the task unless [member custom_name] is set. Returns [code]true[/code] if [param task] is a child of this task. Initilizes the task. Assigns [member agent] and [member blackboard], and calls [method _setup] for the task and its children. The method is called recursively for each child task. [param scene_root] should be the root node of the scene the behavior tree is used in (e.g., the owner of the node that contains the behavior tree). Returns [code]true[/code] if this task is a descendant of [param task]. In other words, this task must be a child of [param task] or one of its children or grandchildren. Returns [code]true[/code] if this task is the root task of its behavior tree. A behavior tree can have only one root task. Returns the next task after this task in the parent's children list. Returns [code]null[/code] if this task has no parent or it is the last child in the parent's children list. Prints the subtree that starts with this task to the console. Removes [param task] from children. Removes a child task at a specified index from children. The agent is the contextual object for the [BehaviorTree] instance. This is usually the parent of the [BTPlayer] node that utilizes the [BehaviorTree] resource. Provides access to the [Blackboard]. Blackboard is used to share data among tasks of the associated [BehaviorTree]. See [Blackboard] for additional info. User-provided name for the task. If not empty, it is used by the editor to represent the task. See [method get_task_name]. Elapsed time since the task was "entered". See [method _enter]. Returns [code]0[/code] when task is not [code]RUNNING[/code]. Root node of the scene the behavior tree is used in (e.g., the owner of the [BTPlayer] node). Can be uses to retrieve [NodePath] references. [b]Example:[/b] [codeblock] extends BTAction @export var node_path: NodePath func _setup(): var node: Node = scene_root.get_node(node_path) [/codeblock] Last execution [enum BT.Status] returned by [method _tick].