TreeFlow.

🏗️ System Architecture 🏗️ Architecture du Système 🏗️ Arquitectura del Sistema 🏗️ 系统架构

Assets/Plugins/TreeFlow/
    ├── Editor/                          # Editor-only code (not in build)
    │   ├── Core/
    │   │   ├── BehaviorTreeEditor.cs    # Main editor window
    │   │   ├── BehaviorTreeView.cs      # Node graph view (GraphView)
    │   │   ├── BTNodeView.cs            # Individual node rendering
    │   │   ├── InspectorView.cs         # Node property inspector
    │   │   ├── NodeSearchWindow.cs      # Add node search popup
    │   │   └── Toolbar.cs               # Editor toolbar
    │   ├── Nodes/                       # Custom node editors
    │   ├── Utilities/                   # Property drawers
    │   ├── BlackboardView.cs            # Blackboard panel
    │   └── BehaviorTreeRunnerEditor.cs  # Inspector for Runner
    │
    └── Runtime/                         # Runtime code (included in build)
        ├── Core/
        │   ├── BTNode.cs                # Base class for ALL nodes
        │   ├── BehaviorTree.cs          # ScriptableObject tree asset
        │   ├── BehaviorTreeRunner.cs    # MonoBehaviour that runs the tree
        │   ├── BlackboardKeyAttribute.cs # Attribute for key selection
        │   ├── BBParameter_GenericTypes.cs
        │   ├── NodeStatus.cs            # Success, Failure, Running enum
        │   └── RootNode.cs              # Entry point node
        ├── Blackboard/
        │   ├── Blackboard.cs            # Key-value storage
        │   ├── BlackboardKey.cs
        │   └── BlackboardValue.cs       # Typed value container
        └── Nodes/                       # Built-in nodes
            ├── ActionNode.cs            # Base for action nodes
            ├── ConditionNode.cs         # Base for condition nodes
            ├── CompositeNode.cs         # Base for composite nodes
            ├── DecoratorNode.cs         # Base for decorator nodes
            ├── SequenceNode.cs          # AND logic
            ├── SelectorNode.cs          # OR logic
            ├── ParallelNode.cs          # Concurrent execution
            ├── WaitActionNode.cs        # Wait for time
            ├── LogNodeAction.cs         # Debug.Log
            └── InverterNodeDecorator.cs # Invert result

📥 Installation 📥 Installation 📥 Instalación 📥 安装

🚀 Quick Start 🚀 Démarrage Rapide 🚀 Inicio Rápido 🚀 快速开始

Follow these 5 steps to create your first behavior tree: Suivez ces 5 étapes pour créer votre premier arbre de comportement : Sigue estos 5 pasos para crear tu primer árbol de comportamiento: 按照以下5个步骤创建您的第一个行为树：

              [Root]
                 │
          [Selector]
          /          \
   [Sequence]      [Sequence]
       │               │
[IsAlert?]      [Patrol]
       │               │
[ChaseTarget]    [Wait 2s]
       │
[Attack]

// Option A: Via Inspector
// Add Component → BehaviorTreeRunner
// Assign your BehaviorTree asset

// Option B: Via Script
using TreeFlow.Runtime.Core;

public class Enemy : MonoBehaviour
{
    public BehaviorTree aiTree;
    
    void Start()
    {
        var runner = gameObject.AddComponent<BehaviorTreeRunner>();
        runner.tree = aiTree;
        runner.updateInterval = 0.1f; // 10 ticks per second
        runner.enableDebug = true;
    }
}

🚦 Node Status 🚦 Statuts des Nodes 🚦 Estados de Nodos 🚦 节点状态

Every node returns one of three statuses that control the flow of execution: Chaque node retourne l'un des trois statuts qui contrôlent le flux d'exécution : Cada nodo devuelve uno de tres estados que controlan el flujo de ejecución: 每个节点返回三个状态之一，控制执行流程：

// TreeFlow/Runtime/Core/NodeStatus.cs
public enum NodeStatus
{
    Running,   // Still executing, call again next tick
    Success,   // Task completed successfully
    Failure    // Task failed
}

🧩 Node Types 🧩 Types de Nodes 🧩 Tipos de Nodos 🧩 节点类型

📋 Blackboard System 📋 Système de Blackboard 📋 Sistema de Blackboard 📋 黑板系统

🎬 Scene Overrides 🎬 Scene Overrides 🎬 Scene Overrides 🎬 场景覆盖

🔀 Composite Nodes 🔀 Nodes Composite 🔀 Nodos Composite 🔀 复合节点

Composite nodes control the flow of execution by managing multiple children. Les nodes composite contrôlent le flux d'exécution en gérant plusieurs enfants. Los nodos composite controlan el flujo de ejecución gestionando múltiples hijos. 复合节点通过管理多个子节点来控制执行流程。

🎭 Decorator Nodes 🎭 Nodes Decorator 🎭 Nodos Decorator 🎭 装饰节点

Decorator nodes wrap a single child and modify its behavior or result. Les nodes decorator enveloppent un seul enfant et modifient son comportement ou résultat. Los nodos decorator envuelven un solo hijo y modifican su comportamiento o resultado. 装饰节点包装单个子节点并修改其行为或结果。

⚡ Action Nodes ⚡ Nodes Action ⚡ Nodos Action ⚡ 动作节点

Action nodes are leaf nodes that perform actual work. They don't have children. Les nodes action sont des feuilles qui effectuent le travail réel. Ils n'ont pas d'enfants. Los nodos action son hojas que realizan trabajo real. No tienen hijos. 动作节点是执行实际工作的叶节点。它们没有子节点。

❓ Condition Nodes ❓ Nodes Condition ❓ Nodos Condition ❓ 条件节点

Condition nodes check a state and return Success (true) or Failure (false). They never return Running. Les nodes condition vérifient un état et retournent Success (vrai) ou Failure (faux). Ils ne retournent jamais Running. Los nodos condition verifican un estado y retornan Success (verdadero) o Failure (falso). Nunca retornan Running. 条件节点检查状态并返回 Success（真）或 Failure（假）。它们永远不会返回 Running。

🔨 Custom Nodes 🔨 Nodes Personnalisés 🔨 Nodos Personalizados 🔨 自定义节点

using TreeFlow.Runtime;
using TreeFlow.Runtime.Core;
using UnityEngine;

// 1. Add NodeInfo attribute to appear in the search menu
[NodeInfo("MyCategory", "MyNodeName", "Description of what it does")]
public class MyCustomAction : ActionNode
{
    // 2. Define parameters (use BB types for flexibility)
    public BBFloat speed = new BBFloat { value = 5f };
    public BBTransform target;

    // 3. Initialize (called once when tree starts)
    protected override void OnStart()
    {
        // Cache components, setup variables
    }

    // 4. Update (called every tick)
    protected override NodeStatus OnUpdate()
    {
        // Return Success, Failure, or Running
        return NodeStatus.Success;
    }

    // 5. Stop (called when node ends or is aborted)
    protected override void OnStop()
    {
        // Cleanup
    }
}

⚙️ Runtime Control ⚙️ Contrôle Runtime ⚙️ Control en Runtime ⚙️ 运行时控制

// Set
runner.Blackboard.SetValue("Health", 100f);

// Get
float hp = runner.Blackboard.GetValue<float>("Health");

// Event
runner.Blackboard.OnValueChanged += (key, val) => { ... };

🎮 Examples 🎮 Exemples 🎮 Ejemplos 🎮 示例

[Root Selector]
 ├── [Sequence: Combat]
 │    ├── [Cond: CanSeePlayer?]
 │    └── [Action: ChasePlayer]
 └── [Sequence: Patrol]
      ├── [Action: GetNextWaypoint]
      ├── [Action: MoveTo]
      └── [Action: Wait 2s]

✨ Best Practices ✨ Bonnes Pratiques ✨ Buenas Prácticas ✨ 最佳实践

🔧 Troubleshooting 🔧 Dépannage 🔧 Solución de problemas 🔧 故障排除