LimboAI标志

LimboAI - Godot 4的行为树和状态机

🛈 支持的Godot引擎版本： 4.3 (v1.2.0+) | 4.2 (v1.1.x 版本)

LimboAI是一个开源的C++插件，为Godot引擎4提供了行为树和状态机的组合，可以一起使用来创建复杂的AI行为。它配备了行为树编辑器、内置文档、可视化调试器、包含教程的庞大演示项目等功能！虽然它是用C++实现的，但完全支持使用GDScript来创建你自己的任务和状态。

如果你喜欢使用LimboAI，请考虑在Ko-fi上支持我的工作😊 你的贡献将帮助我继续开发和改进它。

纹理截图

行为树是用于模型化和控制游戏中代理（如角色、敌人）行为的强大层级结构。它们旨在使创建丰富且高度模块化的游戏行为变得更加容易。要了解更多关于行为树的信息，请查看行为树介绍和我们的演示项目，其中包含一个教程。

演示

演示中的冲锋者

🛈 演示项目位于demo文件夹中，并在Releases中单独提供。运行demo/scenes/showcase.tscn开始使用。它还包括一个通过说明性示例介绍行为树的教程。

视频

🛈 由各种创作者制作的YouTube视频

功能

行为树（BT）：
- 在编辑器中轻松创建、编辑和保存BehaviorTree资源。
- 使用BTPlayer节点执行BehaviorTree资源。
- 通过组合和嵌套任务创建复杂行为。
- 使用组合、装饰器和条件任务控制执行流程。
- 通过扩展核心类创建自定义任务：BTAction、BTCondition、BTDecorator和BTComposite。
- 内置类文档。
- 黑板系统：使用Blackboard在任务之间无缝共享数据。
  - 黑板计划：在BehaviorTree资源中定义变量，并在BTPlayer节点中覆盖它们的值。
  - 计划编辑器：管理变量、数据类型和属性提示。
  - 黑板作用域：防止名称冲突并启用高级技术，如在多个代理之间共享数据。
  - 黑板参数：导出BB参数，用户可以为其提供值或将其绑定到黑板变量（可用于自定义任务）。
  - 检查器支持指定黑板变量（以"_var"结尾的导出StringName属性的自定义编辑器）。
- 使用BTSubtree任务执行不同资源文件中的树，促进组织和可重用性。
- 可视化调试器：检查运行场景中任何BT的执行情况，以识别和解决问题。
- 使用BehaviorTreeView节点在游戏中可视化BT（用于自定义游戏内工具）。
- 使用自定义性能监视器监控树性能。
层级状态机（HSM）：
- 扩展LimboState类以实现状态逻辑。
- LimboHSM节点作为管理LimboState实例和转换的状态机。
- LimboHSM本身是一个状态，可以嵌套在其他LimboHSM实例中。
- 基于事件：转换与事件相关联，当相关事件被分派时由状态机触发，允许更好地将转换与状态逻辑解耦。
- 使用BTState将状态机与行为树结合，实现高级反应式AI。
- 委托选项：使用原生LimboState，将实现委托给你的回调函数，非常适合快速原型设计和游戏jam。
- 🛈 注意：状态机设置和初始化需要代码；没有GUI编辑器。
经过测试： 行为树任务和HSM都有单元测试覆盖。
GDExtension: LimboAI 可以作为扩展使用。无需自定义引擎构建。
演示 + 教程: 查看我们丰富的演示项目，其中包含使用示例介绍行为树。

首要步骤

按照首要步骤指南学习如何开始使用 LimboAI 和演示项目。

获取 LimboAI

LimboAI 可以作为 C++ 模块或 GDExtension 共享库使用。GDExtension 版本使用更方便，但功能有些受限。无论您选择使用哪种方式，您的项目都将保持兼容性，您可以随时在两者之间切换。请参阅使用 GDExtension。

预编译版本

对于最新的构建，请导航至 Actions → All Builds，从列表中选择一个构建，然后向下滚动直到找到 Artifacts 部分。
对于发布版本，请查看 Releases。

从源码编译

下载 Godot 引擎源代码，并将此模块源代码放入 modules/limboai 目录。
参考 Godot 引擎文档了解如何从源代码构建的说明。
如果您计划导出使用 LimboAI 模块的游戏，还需要构建导出模板。
要执行单元测试，请使用 tests=yes 编译引擎，并使用 --test --tc="*[LimboAI]*" 运行。

对于 GDExtension

您需要 SCons 构建工具和 C++ 编译器。另请参阅编译。
运行 scons target=editor 为当前平台构建插件库。
- 如果 limboai/godot-cpp 目录中还不存在 godot-cpp/ 仓库，SCons 会自动克隆它。
- 默认情况下，构建的目标会放置在演示项目中：demo/addons/limboai/bin/
查看 scons -h 了解其他选项和目标。