[](https://github.com/bitbrain/beehave/actions/workflows/beehave-ci.yml) [](https://discord.com/invite/CKBuE5djXe) [](https://shop.bitbra.in)
---
**[Beehave](https://bitbra.in/beehave) is a powerful addon for Godot Engine that enables you to create robust AI systems using behavior trees.** With Beehave, you can easily design complex NPC behaviors, build challenging boss battles, and create other advanced setups with ease.
Using behavior trees, Beehave makes it simple to create highly adaptive AI that responds to changes in the game world and overcomes unexpected obstacles. Whether you are a beginner or an experienced developer, Beehave is the perfect tool to take your game AI to the next level.
# ๐ Features
### ๐ค Node based - build behavior trees within your scene tree
Compose behavior trees in your scene and attach them to any node of your choice.
### ๐ Debug view - a dedicated debug view to analyze your behavior at runtime
A dedicated debug view inside the Godot editor allows you to better understand what the behavior is doing under the hood.
### ๐ Performance - built-in monitors to track performance of your behavior trees
Maintaining high framerate is important in games. Investigate performance issues by using the custom monitor available inside the Godot editor.
### ๐งช Tested - any functionality of this addon is covered by test automation
In order to avoid bugs creeping into the codebase, every feature is covered by unit tests.
# ๐ฆ Installation
1. [Download Latest Release](https://github.com/bitbrain/beehave/releases/latest)
- (optional) access latest build for [Godot 3.x](https://github.com/bitbrain/beehave/archive/refs/heads/godot-3.x.zip), [Godot 4.x](https://github.com/bitbrain/beehave/archive/refs/heads/godot-4.x.zip)
2. Unpack the `addons/beehave` folder into your `/addons` folder within the Godot project
3. Enable this addon within the Godot settings: `Project > Project Settings > Plugins`
4. Move `script_templates` into your project folder.
To better understand what branch to choose from for which Godot version, please refer to this table:
|Godot Version|Beehave Branch|Beehave Version|
|---|---|--|
|`3.x`|`3.x`|`1.x`|
|`4.x`|`4.x`|`2.x`|
|`4.5+`|`4.x`|`2.10+`|
|`4.1.x`|`4.x`|`2.9.x`|
|`4.0.x`|`4.x`|`2.7.x`|
Refer to [this guide](https://bitbra.in/blog/godot-addon-compatibility/) for more details behind this structure.
# ๐ Getting started
Behavior trees are a modular way to build AI logic for your game. For simple AI, behavior trees are definitely overkill, however, for more complex AI interactions, behavior trees can help you to better manage changes and re-use logic across all NPCs.
[Learn how to beehave on the official wiki!](https://bitbra.in/beehave/#/manual/)
## Media
### Beehave Overview (Gamefromscratch)
[](https://www.youtube.com/watch?v=egutKInUfko)
### Godot 4.x Tutorial
[](https://www.youtube.com/watch?v=aru_FojSqDo)
### Godot 3.5 Tutorial
[bitbrain](https://youtube.com/@bitbraindev) recorded this tutorial to show in more depth how to use this addon:
[](https://www.youtube.com/watch?v=n0gVEA1dyPQ)
### Getting Started with Beehave (Liam Flannery)
[Liam Flannery](https://twitter.com/liamflannery56) wrote up a getting started [tutorial](https://medium.com/@liam.flannery56/easily-creating-behaviour-trees-in-godot-4-2-beehave-tutorial-ff8a911d43a0) that's up to date with Godot 4.2
# ๐ฅฐ Credits
- logo designs by [@NathanHoad](https://twitter.com/nathanhoad) & [@StuartDeVille](https://twitter.com/StuartDeVille)
- original addon by [@viniciusgerevini](https://github.com/viniciusgerevini)
- icon design by [@lostptr](https://github.com/lostptr)