limboai · limbonaut/limboai
LimboAI 是面向 Godot 4 的行为树与状态机项目,采用 C++ 编写,仓库主题包括人工智能、行为树、游戏开发与 Godot 引擎。README 标注其支持 Godot Engine 4.6,并提供文档站点、单元测试工作流和许可证等徽章;具体兼容版本与功能范围建...
LimboAI 是面向 Godot Engine 4 的开源 C++ 插件,把 行为树(Behavior Trees) 与 状态机(State Machines) 两种范式组合在一起,用于搭建较复杂的 AI 行为。README 将定位描述为:以 C++ 实现,但完整支持用 GDScript 编写自定义任务与状态。随插件提供的还包括行为树编辑器、内置类文档、可视化调试器,以及带教程的较大规模演示工程。
行为树被定义为一类分层结构,用来建模并控制游戏中角色、敌人等智能体的行为,便于构造模块化程度较高的行为逻辑。官方文档另设「Introduction to Behavior Trees」导论章节,演示工程内也配套入门教程。
LimboAI 既可作为 C++ 模块使用,也可作为 GDExtension 共享库使用。GDExtension 版本使用更方便,但功能略有缩减;两种形态的项目互相兼容,可随时切换。
预编译构建
从源码编译(模块方式)
modules/limboai 目录。tests=yes 编译引擎,并以 --test --tc="*[LimboAI]*" 启动。从源码编译(GDExtension 方式)
scons target=editor 为当前平台构建插件库;若 limboai/godot-cpp 目录下不存在 godot-cpp/ 仓库,SCons 会自动克隆。默认产物输出到演示工程 demo/addons/limboai/bin/。scons -h。README 列出的行为树相关特性包括:
BehaviorTree 资源;通过 BTPlayer 节点执行该资源。BTAction、BTCondition、BTDecorator、BTComposite 编写自定义任务。_var 结尾的导出 StringName 属性的自定义编辑器)。BTSubtree 任务可执行来自另一资源文件的行为树,便于组织与复用。BehaviorTreeView 节点在游戏内可视化行为树,适合自建游戏内工具。LimboState 类实现状态逻辑;LimboHSM 节点作为状态机,管理 LimboState 实例与状态转移。LimboHSM 本身也是状态,可嵌套在其他 LimboHSM 中。BTState 把状态机与行为树结合,实现响应式 AI。LimboState 时,可把实现委托给回调函数,适合快速原型与 Game Jam。此外,行为树任务与 HSM 均有单元测试覆盖;插件可以 GDExtension 形式使用,无需自行编译引擎。
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,以及类参考。
一个用 Python 编写、基于 Groq(Llama 3.3)的交互式文字冒险引擎,由 LLM...
Athena Crisis 是由 Nakazawa Tech 开发的「开放核心」回合制战术策略游戏。...
作者用 Lua 为《创世纪 VII:黑门》编写的替换引擎,官方描述称将提供新的摄...