PlayerEngine

PlayerEngine：Minecraft 的 AI 具身框架

PlayerEngine 是一个服务端框架，旨在从根本上改变 AI NPC 在 Minecraft 中的存在方式。该项目由 Goodbird 开发，突破了客户端模组的局限性，提供了一套强大的工具包，让你自己的自定义生物获得玩家的完整能力。

这个项目的诞生源于超越聊天机器人 NPC 噱头的愿望，为 Player2 AI Game Jam 创作真正具身化的智能体。它的目标不是让原版猪会说话，而是赋能开发者创建能够挖掘、战斗、管理物品栏，并以玩家的水平与世界互动的实体。

故事：从客户端破解到真正的框架

PlayerEngine 的灵感来自于 ChatClef，一个由 Player2 开发的创新模组，它将 AI 连接到玩家的客户端。尽管具有开创性，但它有一个显著的局限性：要拥有 AI 伙伴，就必须运行多个 Minecraft 客户端实例。这既笨重又难以扩展。

PlayerEngine 通过将逻辑移至服务端，并且最重要的是，将玩家般的能力与 PlayerEntity 类本身解耦来解决这个问题。其结果是构建了一个真正的框架，允许任何模组作者赋予其自定义 LivingEntity 以玩家的灵魂。

核心概念：将“玩家”视为一种接口

PlayerEngine 的核心在于，它不将“成为玩家”视为一种特定的实体类型，而是视为一组可以附加到任何生物上的能力。通过实现几个简单的接口，你的自定义生物就能获得以下能力：

• 一个持久的、类似玩家的物品栏（LivingEntityInventory）。
• 与世界交互的能力，可以破坏方块和使用物品（LivingEntityInteractionManager）。
• 通过强大的 Automatone 引擎实现的高级寻路和任务执行能力。

这使得 PlayerEngine 成为 AI“大脑”（如 Player2 API 所提供的那种）的终极“执行器”层。你的大语言模型可以决定要做什么，而 PlayerEngine 则为你的 NPC 提供了执行的身体。

面向开发者的主要特性

• 🤖 赋能你的生物： 专为模组作者设计。轻松将你自己的自定义实体转变为玩家般的智能体。不要仅仅对原版生物进行换肤——让你的独特创造物拥有真正的自主性。
• ⛏️ 真正的世界交互： NPC 可以挖掘方块、使用工具，并与物体进行交互。（注意：尚不支持复杂的建筑功能）。
• 🎒 玩家式物品栏： 每个智能体都管理自己持久的物品栏，从而实现复杂的资源收集、合成和工具管理。
• 🧠 无缝 Player2 集成： PlayerEngine 是 Player2 API 的完美物理对应物。发送像 @get diamond 5 这样的高级指令，然后观察你的智能体执行一系列复杂的任务来实现目标。
• 🛠️ 建立在坚实的基础上：
  • 导航： 由 Automatone 驱动，它是传奇的 Baritone 寻路引擎的一个分支。
  • 任务系统： 改编自 Player2 的 ChatClef 中健壮的任务和命令系统。
  • 模块化： 使用 Cardinal Components 来清晰地附加能力，确保高兼容性和易于集成。

为什么 PlayerEngine “超越了 AI 噱头”

• 集成性： 它是一个用于深度系统集成的框架。NPC 不再仅仅是任务发布者；他们是游戏经济、生态系统和涌现故事中的积极参与者。
• 护栏： PlayerEngine 就是护栏。它提供了一个确定性的、基于游戏逻辑的动作层，能够可靠地执行来自大语言模型的高级目标，并具备回退机制和对游戏世界的深入理解。
• 创造性： 它赋能其他创作者。我们不仅仅展示一个很酷的 NPC；我们为整个社区提供了一个工具，让他们能够构建自己的智能伙伴、对手和动态故事讲述者。
• 稳定性： 站在巨人的肩膀上——Baritone 和 Cardinal Components——PlayerEngine 为雄心勃勃的 AI 项目提供了一个稳定且高性能的基础。

致谢

本项目离不开许多人的工作和支持。

Player2

本框架是为 Player2 AI Game Jam 创建的，旨在与 Player2 API 无缝集成，实现他们关于智能、交互式智能体的愿景。

我们是一支由研究人员和工程师组成的团队，热衷于推动 AI 技术的发展。我们的团队成员曾在一些世界领先的科技公司和研究机构工作过，我们因共同的愿景而团结在一起：构建能够以有意义的方式与世界交互的智能体。

基础与灵感

• Automatone / Baritone： PlayerEngine 强大的导航能力由 Automatone 提供，它是传奇的 Baritone 寻路引擎的一个分支。
• ChatClef： 健壮的任务和命令系统改编自 Player2 的原始 ChatClef 模组，它证明了 AI 智能体在 Minecraft 中的潜力。

特别鸣谢

• Itsuka： 感谢他在 Player2 API 方面的宝贵指导、头脑风暴会议以及严格的测试，帮助塑造了今天的 PlayerEngine。

作者

PlayerEngine 是由 Goodbird 开发的个人项目。现由 Zardov（Discord：Miliardo）维护。