Godot 导向 AI 框架

本项目是一个用于在 Godot 游戏引擎 中以 GDScript 编写复杂且流畅的 AI 移动行为的框架，采用导向行为实现。它适用于 2D 和 3D 游戏。

➡ 关注我们的 Twitter 和 YouTube，获取免费的游戏开发教程、技巧和最新资讯！您也可以购买我们的 Godot 游戏开发课程 来支持我们对自由软件的贡献。

该框架支持所有基础的导向行为，如逃离、跟随、朝向等，同时还支持混合行为、群体行为、避开邻居、沿路径移动、跟随领袖等多种功能。

• Godot 导向 AI 框架
  • 获取框架
  • 简介
  • 框架
    • 工作原理
  • 文档
  • 贡献
  • 支持我们
  • 加入社区

获取框架

本仓库包含框架及其用于学习目的的示例。您可以通过点击绿色的 Code 按钮并选择 Download ZIP 来下载一份副本。然后将 addons/ 目录复制并粘贴到您的项目中。

简介

20 世纪 90 年代，Craig Reynolds 开发了一系列用于常见 AI 行为的算法。这些算法使 AI 角色能够寻找或逃离目标、沿着预定义路径移动，或者朝特定方向转动。它们都是简单且可重复的任务，可以被分解为具体的编程逻辑，因此易于复用、维护、组合和扩展。

虽然 AI 角色的下一步行动依赖于决策和规划算法，但导向行为则决定了它如何从当前帧过渡到下一帧。导向行为会利用现有信息，计算出角色在该时刻应移动的位置。

将这两种系统结合起来，不仅能够实现复杂而优雅的移动效果，还能比 A* 等复杂的寻路算法更加高效。

要点

本项目是针对 Godot 游戏引擎 的一个框架。它借鉴了优秀的 GDX-AI 框架，后者是基于 Java 的 LibGDX 框架的一部分。

框架中的每个类都继承自 Godot 的 Reference 类型。无需构建复杂的场景树；与 AI 移动相关的逻辑可以直接封装在 GDScript 类中。

工作原理

在 GSAI 中，导向代理代表一个角色或车辆。代理存储其位置、朝向、最大速度以及当前速度。代理还会持有一个导向行为对象，该对象会根据代理的当前状态计算出线性或角速度的变化量。

开发者随后可以根据角色的具体情况，以适当的方式应用这一加速度来改变角色的速度，例如使用 RigidBody 的 apply_impulse 方法，或 KinematicBody 的 move_and_slide 方法。

文档

框架的文档和代码参考在此处提供：Godot 导向 AI 框架文档

贡献

如果您遇到任何 bug 或有改进工具的想法，请 提交一个问题。

如果您希望为项目做出贡献，例如修复 bug 或添加新功能，请参阅我们的：

1. 贡献者指南
2. GDScript 风格指南

支持我们

我们致力于自由软件的工作得到了 Godot 游戏开发课程 的赞助。请考虑购买一门课程来支持我们！

如果您喜欢我们的工作，请给这个仓库点个赞！这有助于让更多人发现它。

加入社区

• 您可以加入 GDQuest 社区，在 Discord 上与我们交流。
• 如需快速了解最新动态，请关注我们的 Twitter。
• 我们会在 YouTube 上发布视频教程和重大更新。

Godot Steering AI Framework 快速上手指南

环境准备

• 游戏引擎：Godot Engine（支持 2D 和 3D 项目）
• 脚本语言：GDScript
• 系统要求：无特殊限制，适用于 Godot 支持的所有平台（Windows, macOS, Linux 等）
• 前置依赖：无需额外安装第三方库，框架基于 Godot 原生 Reference 类构建

安装步骤

1. 访问项目仓库页面，点击绿色的 Code 按钮。
2. 选择 Download ZIP 下载压缩包。

   注：若下载速度慢，可尝试使用国内加速工具或镜像站获取 GitHub 资源。

3. 解压下载的文件夹。
4. 将解压后的 addons/ 目录完整复制并粘贴到你 Godot 项目的根目录下。
5. 打开 Godot 编辑器，确保在 项目 -> 项目设置 -> 插件 中启用了该插件（如果插件包含自动注册逻辑）。

基本使用

该框架的核心概念是 Steering Agent（转向代理），它代表一个角色或载具，负责存储位置、方向、速度等信息，并计算所需的线性或角加速度。

核心工作流程

1. 创建代理：实例化一个 steering agent，设置其最大速度和当前状态。
2. 配置行为：为代理添加具体的转向行为（如追逐、逃跑、跟随路径等）。
3. 应用力：在 _physics_process 中获取计算出的加速度，并将其应用到你的游戏节点上（如 RigidBody 或 KinematicBody）。

代码示例

以下是一个最简单的使用逻辑示意（伪代码结构，具体类名请参考官方文档）：

extends KinematicBody

var agent: GSAISteeringAgent
var seek_behavior: GSAISeek
var velocity: Vector3 = Vector3.ZERO

func _ready():
    # 1. 初始化代理
    agent = GSAISteeringAgent.new()
    agent.position = global_transform.origin
    agent.max_linear_speed = 10.0
    
    # 2. 设置行为 (例如：追逐某个目标)
    seek_behavior = GSAISeek.new(agent)
    seek_behavior.target_position = get_node("Target").global_transform.origin
    
    # 将行为添加到代理的控制器中 (具体 API 视版本而定)
    agent.add_behavior(seek_behavior)

func _physics_process(delta):
    # 更新代理位置
    agent.position = global_transform.origin
    
    # 3. 计算加速度
    var acceleration = agent.calculate_steering()
    
    # 4. 应用速度变化
    velocity += acceleration * delta
    velocity = velocity.clamped(agent.max_linear_speed)
    
    # 移动角色 (针对 KinematicBody)
    move_and_slide(velocity)
    
    # 同步回代理数据
    agent.position = global_transform.origin

提示：详细的类参考和行为列表（如 Flee, FollowPath, BlendedBehaviors 等）请查阅 官方文档。