Repolode
提交项目
mindcraft-bots

mindcraft-bots/mindcraft

基于 LLM 与 Mineflayer 驱动的 Minecraft AI 机器人，每个智能体都能在游戏中自主行动并与玩家对话。

在 GitHub 查看
Star
5,979
Fork
987
未关闭 Issue
63
最近提交
12天前

这是什么？

Mindcraft 是一个在 Minecraft Java 版中运行 AI 智能体的框架。它将大语言模型接入基于 Mineflayer 构建的机器人，使智能体能够感知世界、与玩家聊天，并执行采集资源、合成物品等游戏内操作。

智能体通过 JSON 配置文件（profile）设置对话模型、独立的代码模型、可选的视觉模型、嵌入与语音参数，以及人设提示词和示例。项目支持 OpenAI、Gemini、Anthropic、DeepSeek 等多家模型服务商，也可通过 Ollama 使用本地模型。它既可以连接本机局域网世界，也可以用微软账号连接在线服务器，并附带按预设目标运行的任务执行器。

由于允许大模型编写并执行代码存在安全风险，代码功能默认关闭。项目建议在连接任何远程服务器前，先在 Docker 容器中运行。

核心功能

  • 01将大语言模型接入 Mineflayer 机器人，在 Minecraft Java 版中行动。
  • 02支持 OpenAI、Gemini、Anthropic、DeepSeek、Ollama 等多家模型服务。
  • 03可为对话、代码、视觉、嵌入分别指定不同模型。
  • 04通过任务 JSON 文件运行带初始物品和目标的预设任务。
  • 05可通过命令行同时加载多个智能体配置文件。

适用场景

  • 研究大语言模型智能体在具身游戏环境中的多智能体协作。
  • 比较不同大模型扮演游戏角色时的行为表现。
  • 设计带目标的 Minecraft 任务，用于评估智能体能力。
  • 借助 Ollama 在本地模型上运行 Minecraft 智能体，无需外部 API。

快速上手

  1. 1

    安装 Node.js（推荐 v18 或 v20 LTS）

  2. 2

    下载最新版本或克隆仓库

  3. 3

    将 keys.example.json 重命名为 keys.json 并填入 API 密钥

  4. 4

    在项目目录中安装依赖

    npm install

使用前须知

  • 需要受支持的大模型服务商的 API 密钥，默认使用 OpenAI。
  • 需要安装 Minecraft Java 版，且最高支持 v1.21.11。
  • 开启代码编写功能后，大模型可在您的电脑上编写并运行代码，因此不应在此设置下连接公共服务器。

收录于专题

开源 AI Agent 框架与应用机器人与具身智能项目

标签

#minecraft#llm#mineflayer#multi-agent#game-ai#nodejs#embodied-ai

常见问题

mindcraft 是什么？
基于 LLM 与 Mineflayer 驱动的 Minecraft AI 机器人，每个智能体都能在游戏中自主行动并与玩家对话。 Mindcraft 是一个在 Minecraft Java 版中运行 AI 智能体的框架。它将大语言模型接入基于 Mineflayer 构建的机器人，使智能体能够感知世界、与玩家聊天，并执行采集资源、合成物品等游戏内操作。
mindcraft 可以免费使用吗？用的什么许可证？
mindcraft 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
mindcraft 还在维护吗？
活跃维护中。mindcraft 最近一次提交是在 2026年10月27日。
mindcraft 适合用来做什么？
研究大语言模型智能体在具身游戏环境中的多智能体协作。 比较不同大模型扮演游戏角色时的行为表现。 设计带目标的 Minecraft 任务，用于评估智能体能力。 借助 Ollama 在本地模型上运行 Minecraft 智能体，无需外部 API。
mindcraft 怎么安装和运行？
安装 Node.js（推荐 v18 或 v20 LTS） 下载最新版本或克隆仓库 将 keys.example.json 重命名为 keys.json 并填入 API 密钥 在项目目录中安装依赖: npm install
在哪里获取 mindcraft？
源代码和安装说明在 GitHub 上：https://github.com/mindcraft-bots/mindcraft

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目