Blockpal AI

Blockpal AI

用这个模组为你的世界增添一个额外助手！

杂项

Blockpal AI预览查看大图

Blockpal — 你的Minecraft AI伙伴

一个友好的Minecraft（Fabric）AI伙伴，可以建造、战斗、对话和思考。

Blockpal 会将一个名为 Ethan 的类玩家角色投放到你的世界中。你可以用自然语言给它下达目标——通过聊天、命令，或直接对着麦克风说话——它就会去执行：建造、挖矿、收集、战斗、使用箱子。它会本能地自卫、管理自己的装备、用自己的嗓音回复你（如果你愿意，还可以发声），并且完全通过游戏内界面进行配置。它支持单人游戏和多人游戏，你玩基岩版的朋友也可以和它一起玩。

给它装上大脑的最简单方式：连接你已经付费的AI。 Blockpal 运行一个 MCP 服务器，因此 Claude、ChatGPT、Grok 或 Gemini 可以直接连接到你的世界——游戏内不会存储任何 API 密钥。在游戏中运行 /ai mcp，它会显示地址、你的令牌以及需要粘贴的确切配置。它也可以直接与任何兼容 OpenAI 的 API 通信（Hugging Face、OpenAI、Ollama、LM Studio），可以在完全没有互联网的情况下运行本地模型，或者在没有密钥的情况下使用免费的内置 AI。

它像玩家一样游玩，而不是像管理员一样。 Ethan 会观察世界——它能获取到其眼睛所见内容的实际渲染画面——决定做什么，然后编写一个简短脚本，按下自己的移动键和鼠标按钮。它按照工具允许的速度挖矿，触及范围和玩家差不多，打开它旁边的箱子，并且从不传送。这使它比直接生成方块的机器人略显笨拙。但这就是重点。

Modrinth version Modrinth downloads Minecraft 26.x Fabric Loader 0.19.3+ Java 25+ License MIT

特性

Ethan 能做什么

  • 通过 MCP 连接你自己的AI。 将 Claude、ChatGPT、Grok 或 Gemini 指向你的世界，让它驱动伙伴——游戏内不存储密钥，你可以直接在应用自己的窗口中观察它的思考过程。 /ai mcp 会显示地址、令牌和每个应用的设置指南。
  • 单一 AI 连接，绝不重复。 只选择其中一个——MCP、你自己的密钥、Player2、本地 Ollama、免费服务，或者都不选。无需再猜测是哪个提供商在响应，或哪个在计费。
  • 先观察，再写代码。 伙伴会看到从其自身视角渲染的画面，做出决定，然后编写一个按下按键和鼠标按钮的小脚本。它管理的所有事情，玩家本来也可以做到。
  • 它使用箱子。 箱子、大箱子、木桶、潜影盒、漏斗和熔炉——在触手可及的范围内打开，一次处理一组，矿石和燃料会自动放入正确的熔炉槽位。
  • 它从不传送。 伙伴会行走、游泳和攀爬跟随你，就像一个真正生活在这个世界中的生物。（当你第一次进入创造模式时会收到警告，因为你可以在几秒钟内飞得比它快。）
  • 它能独立生存。 即使完全没有连接 AI，它受伤时仍会进食，溺水时会上浮，会逃离火焰，会脱离卡住的状态，并自行设法回到你身边。
  • 自然语言任务规划。 告诉它你想要什么——"建造一个 5x5 的地板"、"清理这些树"、"守卫这个位置"——它就会去执行。
  • 回应对话。 它监听聊天并以第一人称回复。像过来、跟随、停留和停止这样的常见指令会立即处理，无需调用 API。
  • 语音。 按住 V 键并对你的伙伴说话——Whisper large-v3-turbo 会转录你的话，只有你自己的机器人能听到。它会用你为每个机器人选择的文字转语音声音大声回答；与朋友分享它的声音，共享（"链接"）的代理会轮流说话，这样它们永远不会互相打断。
  • 个性。 选择它的说话和行为方式——友好、开朗、暴躁、坚忍、英勇或害羞——或者编写你自己的自定义个性，AI 会检查该个性以保持家庭友好。
  • 本能战斗。 它始终监视威胁，在任何模式下都会自卫，并在生命值低时撤退。
  • 管理自己的装备。 它会拾取掉落的物品，装备找到的最佳武器和护甲，受伤时进食，并丢弃有害物品。
  • 按机器人管理和信任。 拥有多个伙伴，并为每个伙伴进行不同的设置。通过每个机器人的信任列表，让特定的朋友指挥选定的机器人，而重命名、解散和更改信任仅限所有者操作。
  • 从基岩版游玩。 使用 iPad、主机或手机的朋友可以通过 Geyser 代理加入，并与 Ethan 一起玩——无需在基岩版设备上安装模组。
  • 一键托管。 从暂停菜单，或使用 /aihost，Java 版玩家可以下载并启动一个支持基岩版的服务器（Minecraft 加 Fabric 加最新版 Geyser 和 Floodgate），并分享连接地址，这样两个版本的朋友都可以加入。
  • 游戏内设置和管理面板。 用于设置、管理员控制和个性化偏好的选项卡式界面——无需编辑配置文件。
  • 自带密钥和模型。 每位玩家独立的 API 密钥和服务器策划的模型列表，因此不会让一个服务器所有者承担所有费用。
  • 安全护栏。 任务看门狗、服务器范围的机器人上限、命令权限限制，以及一个紧急帧率杀开关，如果性能崩溃，会暂停机器人。

系统要求

  • Minecraft（Java版）26.2
  • Fabric Loader 0.19.3 或更新版本，加上 Fabric API
  • 一个可以思考的 AI——以下任一：你已有的 AI 应用（Claude、ChatGPT、Grok、Gemini）通过 MCP 连接、一个兼容 OpenAI 的 API 密钥（免费的 Hugging Face 令牌即可）、本地 Ollama，或免费的内置服务

快速开始

  1. 下载最新的 Blockpal jar 文件，并将其放入你的 mods 文件夹中，与 Fabric API 放在一起。
  2. 在匹配的 Fabric 版本上启动 Minecraft。
  3. 在游戏中运行 /ai summon 来认识 Ethan。
  4. 给它装上大脑。最简单的方法：运行 /ai connection set mcp 然后运行 /ai mcp，并按照指南将 Claude、ChatGPT、Grok 或 Gemini 指向你的世界。或者使用 /ai mykey 后跟你的令牌来设置 API 密钥。
  5. 尝试一个任务，例如 /ai build a 5x5 floor，或者直接在聊天中输入 "Ethan, follow me"。
  6. 想知道它能看见什么？/ai look 会读出它的实际视野。

完整的设置和配置详细信息在下方链接的 wiki 中。

从基岩版游玩（iPad、主机、手机）

Blockpal 主要在服务器端运行，因此使用 Minecraft 基岩版的朋友可以通过 Geyser 代理加入 Java 服务器，并与 Ethan 一起玩——召唤它、与它对话，并通过聊天和命令给它下达任务，而无需在基岩版设备上安装模组。在服务器上，将 Geyser-Fabric 和 Floodgate-Fabric 添加到 mods 文件夹中；Blockpal 将 Floodgate 视为可选，因此没有它服务器也能正常运作。

如果你还没有服务器，Java 版玩家只需点击几下即可托管一个。从暂停菜单中选择 "Host with Blockpal"，或运行 /aihost：它会从其官方来源下载 Minecraft、Fabric 以及最新版 Geyser 和 Floodgate，启动一个服务器，并显示 Java 和基岩版的连接地址。只有 Java 版可以托管；基岩版玩家加入。显示的地址是你自己电脑的地址，而互联网上的朋友仍然需要转发端口，因此只与你信任的人分享。

视觉菜单和帧率看门狗是 Java 客户端功能，因此基岩版玩家将使用文本和命令替代方案。一个粗糙的边角：Geyser 没有通用的自定义实体支持，因此 Ethan 的外观在基岩版上可能渲染异常，尽管它完全正常工作。

与它对话——语音

按住 V 键（可重新绑定）并说出你想要的内容。你的话语会通过 Whisper large-v3-turbo 转录，并直接发送给你自己的伙伴——绝不会公开聊天。它的回复会私下大声读出：除非你 /ai voice share 与朋友分享，否则只有你能听到你的代理，而共享的代理会轮流说话，而不是互相打断。详细信息请参阅下方链接的 wiki 中的 Voice 页面。

常用命令

以下是一些入门命令；完整列表在 wiki 中。

  • /ai summon [name] — 生成一个伙伴
  • /ai mcp — 将 Claude、ChatGPT、Grok 或 Gemini 连接到你的世界
  • /ai connection — 查看（或切换）正在使用的 AI 连接
  • /ai look — 读取你的伙伴实际能看到的内容
  • /ai come、/ai follow、/ai stay、/ai stop — 基本指令
  • /ai <task> — 下达自然语言任务
  • /ai voice — 语音状态；按住 V 键与它对话；/ai voice share <player> 进行共享
  • /ai personality [id] — 更改它的说话和行为方式
  • /ai trust <player> — 让朋友指挥你的机器人
  • /ai panel — 打开设置和管理界面
  • /ai mykey <token> — 设置你的个人 AI 密钥
  • /aihost — 托管一个支持基岩版的服务器（仅限 Java 客户端）

文档

完整文档位于 wiki 中：