search

bitbrain / beehave

🐝 behavior tree AI for Godot Engine
https://bitbra.in/beehave
MIT License
1.99k stars 122 forks source link
ai behavior-tree game-development gamedev gdscript godot godot3 godot4 godotengine

readme

logo

beehave-ci

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
  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.1.x 4.x 2.7.x
4.0.x 4.x 2.7.x

Refer to this guide 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.

example

Learn how to beehave on the official wiki!

Tutorial (Godot 3.5+)

bitbrain recorded this tutorial to show in more depth how to use this addon:

tutorial-thumbnail

Liam Flannery wrote up a getting started tutorial that's up to date with Godot 4.2

🥰 Credits