yc-software/minecraft-agent-harness

这是什么？

核心功能

• 01支持 Claude、GPT、Gemini、OpenRouter 及兼容 OpenAI Responses API 的端点。
• 02使用相同名称重启代理时，会话可以继续。
• 03每个代理可通过 E2B、Docker 或本地目录获得独立 Shell。
• 04用单个 JSON 文件定义多代理团队，成员之间可以私信。
• 05提供带 Paper 服务器的 Docker Compose 配置。

适用场景

• 研究大语言模型代理在 Minecraft 世界中的自主行为。
• 让多个 AI 玩家通过聊天协同完成任务。
• 在带裁判规则的起床战争等游戏场景中测试代理表现。
• 观察代理如何借助 Shell 沙箱编写调用游戏工具的脚本。

快速上手

1. 1

   安装依赖

   npm ci
2. 2

   复制环境变量文件并填入模型提供商的 API 密钥

   cp .env.example .env
3. 3

   启动开发用 Minecraft 服务器（需要 Java 21）

   npm run server
4. 4

   在第二个终端中启动一个带目标的智能体

   npm start -- --objective "Gather wood and build a small shelter near spawn"

使用前须知

• !需要 Node 22.19+、模型提供商的 API 密钥以及一个 Minecraft 服务器。
• !若未检测到 Docker 或 E2B，智能体的 shell 默认为本地文件夹，命令会以你的用户身份运行，除非使用 --sandbox none。
• !视觉功能处于实验阶段。
• !项目较新，仅有 100 个星标，可能存在不少粗糙之处。

收录于专题

标签

常见问题

minecraft-agent-harness 是什么？

让大语言模型代理以玩家身份进入 Minecraft，支持断点续接、沙箱与多代理协作。 minecraft-agent-harness 把大语言模型接入 Minecraft 服务器，让它像普通玩家一样行动。行走、挖掘、合成、建造、战斗和聊天都通过 Mineflayer 完成，模型会话由 pi 管理。可用的模型包括 Claude、GPT、Gemini、OpenRouter，也可以接入任何兼容 OpenAI Responses API 的端点。

minecraft-agent-harness 可以免费使用吗？用的什么许可证？

minecraft-agent-harness 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

minecraft-agent-harness 还在维护吗？

活跃维护中。minecraft-agent-harness 最近一次提交是在 2026年10月29日。

minecraft-agent-harness 适合用来做什么？

研究大语言模型代理在 Minecraft 世界中的自主行为。 让多个 AI 玩家通过聊天协同完成任务。 在带裁判规则的起床战争等游戏场景中测试代理表现。 观察代理如何借助 Shell 沙箱编写调用游戏工具的脚本。

minecraft-agent-harness 怎么安装和运行？

安装依赖: npm ci 复制环境变量文件并填入模型提供商的 API 密钥: cp .env.example .env 启动开发用 Minecraft 服务器（需要 Java 21）: npm run server 在第二个终端中启动一个带目标的智能体: npm start -- --objective "Gather wood and build a small shelter near spawn"

在哪里获取 minecraft-agent-harness？

源代码和安装说明在 GitHub 上：https://github.com/yc-software/minecraft-agent-harness