Overview
Behavior Designer provides one editor for creating, selecting, validating, and debugging behavior trees. Open it from Tools > Behavior Designer > Editor.
Understand the editor

- The graph contains the Entry task, connected tasks, and their execution order.
- The properties panel switches between Behavior, Tasks, Variables, and Inspector.
- The operations toolbar selects trees and referenced behaviors, adds or removes components, locks the current tree, exports it, searches it, captures the graph, and opens preferences.
- The bottom debug controls start, pause, or step Play Mode. When the open tree contains structural errors, the error indicator opens the Error Window with more information.
The graph traverses from top to bottom. Sibling order runs from left to right unless a parent task defines different behavior. Drag from a parent connection point to a child connection point, select a connection and press Delete to remove it, and drag sibling tasks horizontally to change their order.
Create and edit a tree
- Select the GameObject that will own the behavior.
- Add a Behavior Tree component, then select Open in its Inspector. You can also right-click the empty graph and select Add Behavior Tree.
- Press Space, use the Tasks panel, or right-click empty graph space and choose Add Task.
- Add a Composite such as Sequence or Selector, add its children, and connect the tasks.
- Select a task to edit its serialized fields in Inspector. A red error badge indicates an invalid connection or required value.

Use Behavior Tree Flow for a complete first-tree workflow.
Use the operations toolbar

| Label | Control | Result |
|---|---|---|
| 1 | Back | Moves to the previous tree in the editor’s selection history. |
| 2 | Forward | Moves to the next tree in the editor’s selection history. |
| 3 | GameObject | Selects a scene object or prefab that contains a behavior. |
| 4 | Behavior | Selects one Behavior Tree component when the object has several. |
| 5 | Referenced Behaviors | Opens an External Behavior Tree reached by the current tree. |
| 6 | - |
Removes the current Behavior Tree after confirmation. |
| 7 | + |
Adds another Behavior Tree component to the selected GameObject. |
| 8 | Lock | Keeps the current tree open while the Unity selection changes. |
| 9 | Export | Saves the complete tree as an External Behavior Tree asset. |
| 10 | Find | Searches task names and task types in the current tree. |
| 11 | Take Screenshot | Exports the graph itself; this is separate from documentation capture. |
| 12 | Preferences | Opens the Behavior Designer editor settings. |
Right-click a task for Edit Script, Locate Script, Enable/Disable, Expand/Collapse, Set/Remove Breakpoint, clipboard commands, Replace, and Delete. Right-click empty graph space to add or paste tasks. The same menu can add or remove a Behavior Tree and save the current tree as an External Behavior Tree.
Configure preferences
Open Preferences from the operations toolbar. These settings affect editor presentation and authoring unless stated otherwise.
| Preference | What it changes |
|---|---|
| Show welcome screen | Opens the product welcome window when Unity loads. |
| Show Behavior Designer icon in the scene / hierarchy | Shows product indicators in the Scene view or Hierarchy. |
| Open inspector on single task selection / task double click | Controls when the properties panel switches to Inspector. |
| Fade tasks after they are done running | Fades completed runtime status after its display interval. |
| Position properties panel on the left | Moves the four-tab properties panel between the left and right edge. |
| Mouse wheel scrolls graph view | Uses the wheel for scrolling instead of the normal zoom behavior. |
| Paste copied task at the cursor location | Pastes at the pointer instead of the source-relative position. |
| Grouped fields start visible | Expands grouped task fields by default. |
| Compact mode | Uses smaller task nodes with less icon detail. |
| Snap to grid | Aligns moved tasks to the graph grid. |
| Show selected task description | Displays the selected task’s TaskDescription text in the graph. |
| Record undo/redo | Registers supported graph edits with Unity’s Undo system. |
| Realtime error checking | Updates structural and field errors while authoring. |
| Select GameObject if a breakpoint is hit | Selects the tree owner when runtime execution reaches a breakpoint. |
| Check for updates | Enables the product update check. |
| Add Game GUI Component | Adds the legacy runtime GUI helper when a tree is created. Leave it off unless that debug UI is required. |
| Serialization | Chooses JSON or binary behavior data. Commit the project before changing an established serialization format. |
| Gizmos View Mode | Chooses when Behavior Designer task gizmos appear in the Scene view. |
| Quick Search Key Code | Rebinds the key that opens task search; Space is the default. |
| Zoom Speed Multiplier | Changes graph zoom sensitivity. |
Use Restore to Defaults only when you intentionally want to reset every Behavior Designer preference.
Related:
- Debugging explains runtime colors, result icons, breakpoints, watched fields, and task-change logs.
- Variables covers local, dynamic, and global data.
- External Behavior Trees covers reusable graph assets.