Behavior Tree Node Reference: Composites

Reference for the Behavior Tree Composite nodes.

Windows
MacOS
Linux

Composite nodes define the root of a branch, and the base rules for how that branch is executed. They can have Decorators applied to them to modify entry into their branch, or even cancel out mid-execution. Also, they can have Services attached to them that will only be active if the children of the Composite are being executed. 

Only Composite nodes can be attached to the Root node of a Behavior Tree.

Selector

Selector_01.png

Selector Nodes execute their children from left to right. They stop executing when one of their children succeeds. If a Selector's child succeeds, the Selector succeeds. If all the Selector's children fail, the Selector fails.

Property

Description

Apply Decorator Scope

If set, all Decorators in the branch below will be removed when execution flow leaves the branch (Decorators on this node are not affected).

Node Name

The name the node should display in the Behavior Tree graph.

Sequence

Sequence_01.png

Sequence nodes execute their children from left to right. They stop executing when one of their children fails. If a child fails, then the Sequence fails. If all the Sequence's children succeed, then the Sequence succeeds.

Property

Description

Apply Decorator Scope

If set, all Decorators in the branch below will be removed when execution flow leaves the branch (Decorators on this node are not affected).

Node Name

The name the node should display in the Behavior Tree graph.

Simple Parallel

SimpleParallel_01.png

The Simple Parallel node allows a single main Task node to be executed alongside of a full tree. When the main Task finishes, the setting in Finish Mode dictates if the node should finish immediately, aborting the secondary tree, or if it should delay for the secondary tree to finish.

Property

Description

Finish Mode

Immediate

Once the main Task finishes, the background tree will be aborted.

Delayed

The background tree will be permitted to finish once the main Task has finished.

Node Name

The name the node should display in the Behavior Tree graph.

Welcome to the new Unreal Engine 4 Documentation site!

We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

We'll be sure to let you know when the new system is up and running.

Post Feedback