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）的终极“执行器”层。你的 LLM 可以决定要做什么，而 PlayerEngine 则赋予 NPC 身体，让它真正行动起来。

面向开发者的主要功能

• 🤖 赋予你的生物行动能力：专为模组开发者设计。轻松将自定义实体改造成类似玩家的智能体。别只给原版生物换个皮肤——让你独特的创作真正拥有自主行动能力。
• ⛏️ 真正与世界互动：NPC 可以挖掘方块、使用工具并与物体互动。（注意：目前尚不支持复杂建造。）
• 🎒 类似玩家的物品栏：每个智能体都会管理自己的持久化物品栏，从而能够进行复杂的资源收集、合成和工具管理。
• 🧠 与 Player2 无缝集成：PlayerEngine 是 Player2 API 的理想实体配套。发送 @get diamond 5 这样的高层指令，就能看到智能体执行一连串复杂任务来达成目标。
• 🛠️ 构建于坚实基础之上：
  • 导航： 由 Automatone 提供支持，它是传奇寻路引擎 Baritone 的分支。
  • 任务系统： 采用了 Player2 的 ChatClef 中健壮的任务和命令系统。
  • 模块化： 使用 Cardinal Components 来干净地附加能力，确保高兼容性和易于集成。

为什么 PlayerEngine “超越 AI 噱头”

• 集成： 它是一个深度系统集成的框架。NPC 不再只是任务发布者；它们是游戏经济、生态和涌现故事中的积极参与者。
• 护栏： PlayerEngine 就是 护栏。它提供了一个确定性的、基于游戏逻辑的动作层，能够可靠地执行来自 LLM 的高层目标，并配有回退机制和对游戏世界的稳健理解。
• 创造力： 它赋能 其他创作者。我们不只是展示一个酷炫的 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）维护。