limbonaut / limboai

# LimboAI - Behavior Trees & State Machines for Godot 4
>**Supported Godot Engine:** **4.6**
> *(see below for older versions)*
**LimboAI** is an open-source C++ plugin for **Godot Engine 4** providing a combination of
**Behavior Trees** and **State Machines**, which can be used together to create complex AI behaviors.
It comes with a behavior tree editor, built-in documentation, visual debugger, extensive demo project with a tutorial, and more!
While it is implemented in C++, it fully supports GDScript for creating your own tasks and states.
If you enjoy using LimboAI, please **consider supporting** my efforts with a donation on Ko-fi 😊 Your contribution will help me continue developing and improving it.
Behavior Trees are powerful hierarchical structures used to model and control the behavior of agents in a game (e.g., characters, enemies). They are designed to make it easier to create rich and highly modular behaviors for your games. To learn more about behavior trees, check out Introduction to Behavior Trees and our demo project, which includes a tutorial.
## Demonstration
> [!NOTE]
> **Demo project** lives in the `demo` folder, and is available separately in **Releases**.
> Run `demo/scenes/showcase.tscn` to get started.
> It also includes a tutorial that introduces behavior trees through illustrative examples.
### Videos
> YouTube videos produced by various creators
## Supported Godot versions
| Plugin Version | GDExtension/AssetLib | Module |
|--------------------------|------------------------|-----------|
| `1.8.x` releases | Godot 4.6 or higher | Godot 4.7 |
| `1.7.x` releases | Godot 4.6 or higher | Godot 4.6 |
| `1.6.x` releases | Godot 4.4, 4.5, 4.6 | Godot 4.6 |
| `1.5.x` releases | Godot 4.4, 4.5 | Godot 4.5 |
| `1.4.x` releases | Godot 4.4, 4.5 | Godot 4.4 |
| `1.2.0`-`1.3.x` releases | Godot 4.3 | Godot 4.3 |
| `1.1.x` releases | Godot 4.2 | Godot 4.2 |
## Features
- **Behavior Trees (BT):**
 - Easily create, edit, and save `BehaviorTree` resources in the editor.
 - Execute `BehaviorTree` resources using the `BTPlayer` node.
 - Create complex behaviors by combining and nesting tasks in a hierarchy.
 - Control execution flow using composite, decorator, and condition tasks.
 - Create custom tasks by extending core classes: `BTAction`, `BTCondition`, `BTDecorator`, and `BTComposite`.
 - Built-in class documentation.
 - Blackboard system: Share data seamlessly between tasks using the `Blackboard`.
 - Blackboard plans: Define variables in the BehaviorTree resource and override their values in the BTPlayer node.
 - Plan editor: Manage variables, their data types and property hints.
 - Blackboard scopes: Prevent name conflicts and enable advanced techniques like sharing data between several agents.
 - Blackboard parameters: Export a BB parameter, for which user can provide a value or bind it to a blackboard variable (can be used in custom tasks).
 - Inspector support for specifying blackboard variables (custom editor for exported `Strin