(Jenkins)

一个完全用 Java 编写的用于游戏开发的人工智能框架，基于 libGDX。

gdxAI 项目是 libGDX 的一个扩展，隶属于 libGDX 生态。不过，如果你不想使用 libGDX 框架，它并不会强制你这样做。libGDX 的 JAR 包仍然是必需的，主要是因为 gdxAI 使用了 libGDX 的集合类，这些集合类针对移动平台进行了优化，通过减少垃圾回收和直接支持原始类型来避免装箱和拆箱操作。

gdxAI 致力于成为一个高性能的框架，提供游戏行业中常用的几种人工智能技术。然而，在当前的技术水平下，gdxAI 只覆盖了整个游戏 AI 领域的一部分，而这一领域实际上非常庞大。我们努力聚焦于游戏 AI 开发中最关键的部分，并且未来还会不断加入更多功能。

目前支持的功能包括：

• 移动 AI
  • 导向行为
  • 队形运动
• 路径规划
  • A*
  • 分层路径规划
  • 路径平滑
  • 可中断路径规划
• 决策制定
  • 状态机
  • 行为树
• 基础设施
  • 消息处理
  • 任务调度

入门指南

• 在你的项目中使用 gdxAI
• 阅读维基文档
• 查阅 Javadoc 文档
• 查看示例代码
• 实用链接与资源

新闻与社区

请关注 libGDX 博客 获取最新消息和更新。你也可以在我们的 Discord 社区 寻求帮助。

报告问题

遇到某些功能没有按预期工作的情况吗？或者需要尚未实现的新功能吗？请先查看 问题追踪器，如果问题尚未被列出，再提交一个新的问题。请尽量详细描述你的问题，并提供复现步骤。

贡献代码

太棒了！如果你想贡献新功能或修复 bug，请 fork 这个仓库 并 提交 pull request。此外，在我们接受重要的代码贡献之前，你需要签署 libGDX 贡献者许可协议。

许可证

gdxAI 项目采用 Apache 2.0 许可证，这意味着你可以免费使用它，无论是在商业项目还是非商业项目中，都不受任何附加条件限制。如果你使用 gdxAI 发布游戏或应用，我们也非常欢迎你给予适当的署名（非强制性）！

gdx-ai 快速上手指南

gdx-ai 是一个专为游戏开发设计的高性能人工智能框架，完全由 Java 编写。虽然它是 libGDX 的扩展项目，但并不强制你使用 libGDX 作为唯一的游戏框架（不过仍需引入 libGDX 的核心 jar 包以利用其优化的集合类）。它提供了移动行为、寻路算法、决策树等游戏行业常用的 AI 技术。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：Windows, macOS, 或 Linux
• JDK 版本：Java 8 或更高版本
• 构建工具：Gradle (推荐) 或 Maven
• 前置依赖：
  • 必须引入 libgdx 核心库。
  • gdx-ai 依赖 libGDX 的集合类（如 Array, Map 等），这些类针对移动平台进行了优化，可减少垃圾回收并直接支持原始类型。

安装步骤

推荐使用 Gradle 进行依赖管理。在你的项目构建文件（build.gradle）中添加以下配置。

1. 添加仓库源

确保你的 repositories 块中包含 Maven Central 或 Google 的 Maven 仓库（国内开发者若访问缓慢，可配置阿里云镜像）：

repositories {
    mavenCentral()
    // 国内加速推荐：阿里云镜像
    // maven { url 'https://maven.aliyun.com/repository/public' }
}

2. 添加依赖

在 dependencies 块中添加 gdx-ai。请将 <version> 替换为最新版本号（可在 Maven Central 查询，例如 1.8.2）：

dependencies {
    implementation "com.badlogicgames.gdx:gdx-ai:<version>"
    
    // 确保同时引入了 libgdx 核心包
    implementation "com.badlogicgames.gdx:gdx:<libgdx-version>"
}

如果你使用的是 Maven，请在 pom.xml 中添加：

<dependency>
    <groupId>com.badlogicgames.gdx</groupId>
    <artifactId>gdx-ai</artifactId>
    <version><version></version>
</dependency>

基本使用

gdx-ai 的核心功能包括转向行为（Steering Behaviors）、寻路（Pathfinding）和决策系统（状态机/行为树）。以下是一个最简单的转向行为（Steering Behavior）使用示例，展示如何让一个角色自动朝向目标移动。

代码示例

假设你有一个实现了 Steerable<Vector2> 接口的角色类 Boid，以及一个目标点。

import com.badlogic.gdx.ai.steer.SteeringBehavior;
import com.badlogic.gdx.ai.steer.behaviors.Seek;
import com.badlogic.gdx.math.Vector2;

// 假设 boid 是你的游戏角色实例，targetPosition 是目标坐标
Boid boid = new Boid(); 
Vector2 targetPosition = new Vector2(100f, 100f);

// 创建 Seek (追逐) 行为
SteeringBehavior<Vector2> seekBehavior = new Seek<>(boid, targetPosition);

// 在游戏循环的 update 方法中调用
public void update(float deltaTime) {
    // 计算并应用转向力
    boid.calculateSteeringForce(deltaTime, seekBehavior);
    
    // 更新角色位置 (具体实现取决于你的 Boid 类)
    boid.update(deltaTime);
}

关键点说明

1. Steerable 接口：你的游戏实体需要实现 Steerable<T> 接口，提供位置、速度、最大速度等属性。
2. Behavior 创建：通过继承 SteeringBehavior 的类（如 Seek, Arrive, Wander）创建具体的 AI 逻辑。
3. 计算与更新：每一帧调用 calculateSteeringForce 来计算合力，然后更新实体状态。

更多高级用法（如 A* 寻路、行为树构建）请参考官方 Wiki 或查看项目中的 tests 目录获取完整示例。