本页目录

LimboAI:Godot 4 行为树与状态机 AI 组件

limboai · limbonaut/limboai

LimboAI 是面向 Godot 4 的行为树与状态机项目,采用 C++ 编写,仓库主题包括人工智能、行为树、游戏开发与 Godot 引擎。README 标注其支持 Godot Engine 4.6,并提供文档站点、单元测试工作流和许可证等徽章;具体兼容版本与功能范围建...

文字冒险 Unity C# 对话系统 高级
★ Stars 3,133 Forks 158 License MIT 更新 2026-11-18

国内开发环境适配

Windows
未知
Linux
未知
macOS
未知
引擎 / 框架:Unity 暂无中文教程标记 未标记站长实测
GDExtension 方式构建需要 SCons 与 C++ 编译器,SCons 在本地缺少 godot-cpp 时会自动从 GitHub 克隆仓库,国内网络环境下可能需要配置代理或手动放置 godot-cpp;模块方式需下载 Godot 引擎源码并按官方流程编译,耗时较长。具体镜像与网络方案待核验。

中文项目介绍

LimboAI 是面向 Godot Engine 4 的开源 C++ 插件,把 行为树(Behavior Trees) 与 状态机(State Machines) 两种范式组合在一起,用于搭建较复杂的 AI 行为。README 将定位描述为:以 C++ 实现,但完整支持用 GDScript 编写自定义任务与状态。随插件提供的还包括行为树编辑器、内置类文档、可视化调试器,以及带教程的较大规模演示工程。

行为树被定义为一类分层结构,用来建模并控制游戏中角色、敌人等智能体的行为,便于构造模块化程度较高的行为逻辑。官方文档另设「Introduction to Behavior Trees」导论章节,演示工程内也配套入门教程。

技术架构分析

获取与构建

LimboAI 既可作为 C++ 模块使用,也可作为 GDExtension 共享库使用。GDExtension 版本使用更方便,但功能略有缩减;两种形态的项目互相兼容,可随时切换。

预编译构建

  • 最新构建:进入仓库 Actions → All Builds,选择列表中的某次构建,向下滚动到 Artifacts 区域。
  • 发布构建:查看 Releases。

从源码编译(模块方式)

  • 下载 Godot 引擎源码,把本模块源码放入 modules/limboai 目录。
  • 按 Godot 官方文档的源码编译说明操作。
  • 若要导出使用该模块的游戏,还需构建导出模板。
  • 运行单元测试需以 tests=yes 编译引擎,并以 --test --tc="*[LimboAI]*" 启动。

从源码编译(GDExtension 方式)

  • 需要 SCons 构建工具与 C++ 编译器。
  • 执行 scons target=editor 为当前平台构建插件库;若 limboai/godot-cpp 目录下不存在 godot-cpp/ 仓库,SCons 会自动克隆。默认产物输出到演示工程 demo/addons/limboai/bin/。
  • 其他选项与目标见 scons -h。

补充说明

行为树能力

README 列出的行为树相关特性包括:

  • 在编辑器内创建、编辑并保存 BehaviorTree 资源;通过 BTPlayer 节点执行该资源。
  • 在层级中组合、嵌套任务,构成复杂行为;用组合(composite)、装饰(decorator)、条件(condition)任务控制执行流。
  • 通过继承核心类 BTAction、BTCondition、BTDecorator、BTComposite 编写自定义任务。
  • 内置类文档。
  • 黑板(Blackboard)系统:在任务之间共享数据;支持黑板计划(在 BehaviorTree 资源中定义变量、在 BTPlayer 节点覆盖取值)、计划编辑器(管理变量、数据类型与属性提示)、黑板作用域(避免重名,并支持多智能体共享数据等用法)、黑板参数(导出参数后可由用户赋值或绑定到黑板变量),以及在 Inspector 中指定黑板变量(针对以 _var 结尾的导出 StringName 属性的自定义编辑器)。
  • BTSubtree 任务可执行来自另一资源文件的行为树,便于组织与复用。
  • 可视化调试器:在运行中的场景里查看任意行为树的执行情况,用于定位问题。
  • 通过 BehaviorTreeView 节点在游戏内可视化行为树,适合自建游戏内工具。
  • 使用自定义性能监视器观察行为树运行开销。

层级状态机能力

  • 继承 LimboState 类实现状态逻辑;LimboHSM 节点作为状态机,管理 LimboState 实例与状态转移。
  • LimboHSM 本身也是状态,可嵌套在其他 LimboHSM 中。
  • 基于事件:转移与事件关联,在状态机派发相应事件时触发,使转移与状态逻辑解耦。
  • 通过 BTState 把状态机与行为树结合,实现响应式 AI。
  • 委托选项:使用原生 LimboState 时,可把实现委托给回调函数,适合快速原型与 Game Jam。
  • 需注意:状态机的搭建与初始化需要写代码,没有 GUI 编辑器。

此外,行为树任务与 HSM 均有单元测试覆盖;插件可以 GDExtension 形式使用,无需自行编译引擎。

支持的 Godot 版本

README 给出的版本对应关系如下(GDExtension / AssetLib 与 Module 两列含义不同):

插件版本 GDExtension/AssetLib Module
1.8.x Godot 4.6 或更高 Godot 4.7
1.7.x Godot 4.6 或更高 Godot 4.6
1.6.x Godot 4.4、4.5、4.6 Godot 4.6
1.5.x Godot 4.4、4.5 Godot 4.5
1.4.x Godot 4.4、4.5 Godot 4.4
1.2.0-1.3.x Godot 4.3 Godot 4.3
1.1.x Godot 4.2 Godot 4.2

页首标注的「Supported Godot Engine: 4.6」即对应最新版本线,实际项目请按上表选择插件版本。

演示与学习路径

演示工程位于仓库 demo 文件夹,也在 Releases 中单独提供;运行 demo/scenes/showcase.tscn 即可开始,其中包含用示例讲解行为树的教程。README 还列出了若干由社区创作者制作的 YouTube 视频。

在线文档提供 stable 与 latest 两个版本,常用入口包括:Getting started、Introduction to Behavior Trees、在 GDScript 中创建自定义任务、使用 Blackboard 共享数据、访问场景树中的节点、状态机、使用 GDExtension、在 C# 中使用 LimboAI,以及类参考。

开源许可证与版权说明

许可证标识:MIT。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目