AB
AB
AiBoss站

全部分类

project

minecraft-agent-harness - 让 LLM 智能体像普通玩家一样玩 Minecraft

minecraft-agent-harness 是 yc-software 维护的 MIT 开源项目，把大模型接到 Minecraft 服务器上，通过 Mineflayer 让智能体行走、挖矿、合成、建造、战斗和聊天。项目自述支持多种模型提供方、可跨重启恢复的会话、每个智能体的沙箱 shell，以及用单个 JSON 文件定义的团队。

minecraft-agent-harness 是一个把大语言模型接到 Minecraft 服务器上的开源框架：你给智能体一个目标，它就以普通玩家的身份进入世界，行走、挖矿、合成、建造、战斗、聊天。据项目自述，智能体通过 Mineflayer 操作游戏，模型会话由 pi 负责。它适合想观察或实验「LLM 在开放世界里长期行动」的开发者，也适合需要多智能体协作场景的研究者——README 称项目方曾用它跑过 Bed Wars 对局，以及一个同时容纳 50 个智能体的生存服务器。

维护者与状态

仓库由 yc-software 维护，地址为 github.com/yc-software/minecraft-agent-harness，采用 MIT 许可证。仓库创建于 2026-10-29，最后提交时间同为 2026-10-29，属于非常新的项目。截至 2026-11-09，星标数为 193。项目尚无正式 release，目前只能从仓库源码使用，没有版本化的发行包可依赖。

主要能力

以下能力均来自项目 README 的自述，未经独立验证：

  • 多模型接入：支持 Claude、GPT、Gemini、OpenRouter，也可以指向任何兼容 OpenAI Responses API 的自有端点。
  • 会话可跨重启恢复：智能体的全部状态存放在 .agent-state/<name>/ 下，终止进程后用同一名字重新启动，会话会接着继续。
  • 每个智能体一个 shell：可选 Docker、E2B 或普通本地目录。智能体可以在其中记笔记，并编写调用自身游戏工具的小脚本。
  • 团队协作：用一个 JSON 文件定义多个智能体，支持智能体之间私信，以及可选的共享机器。
  • 视觉能力：README 标注为实验性，可按需开启。

使用入口

项目仓库：minecraft-agent-harness。

据 README，运行前需要 Node 22.19+、某个模型提供方的 API key，以及一台 Minecraft 服务器；若没有服务器，仓库自带一个开发用服务器，需要 Java 21。基本流程是安装依赖、复制 .env.example 为 .env 并填入 API key，然后启动：

npm ci
cp .env.example .env
npm run server
npm start -- --objective "Gather wood and build a small shelter near spawn"

自带服务器为 localhost:25565 上的 Paper 1.21.6，离线模式；默认模型为 GPT-6.1 Terra。连接自己的服务器时用 --host 与 --port 指定地址，在线模式服务器需要 --auth microsoft。也可以用 docker compose up 一次拉起服务器与一个智能体，目标通过 .env 中的 AGENT_OBJECTIVE 修改。启动团队则使用 npm start -- team examples/team.json。配置可通过命令行参数、环境变量或 --config 指定的 JSON 文件给出，优先级为参数高于环境变量、环境变量高于文件。

许可与限制

项目采用 MIT 许可证。README 说明部分技能库来自 Mindcraft，渲染 worker 来自 prismarine-viewer，其许可证列在 THIRD_PARTY_NOTICES.md 中，二次分发时需一并留意。

使用边界方面，据项目说明：智能体默认假设处于生存模式，服务器若使用其他模式需通过 --game-mode 指定；沙箱默认开启，优先 E2B（设置了 E2B_API_KEY 时），其次 Docker（若在运行），最后回退到本地目录——本地模式意味着智能体的命令以当前用户身份执行，不希望智能体拥有 shell 时可传 --sandbox none。视觉功能仍属实验性。项目尚无正式 release，接口与配置项可能随提交变动。

返回