mindcraft

用自然语言指挥 AI 在《我的世界》里干活

mindcraft 是一个把大语言模型接入《我的世界》的开源项目，基于 JavaScript 和 Mineflayer 实现。它让 AI 驱动的机器人真正进入游戏世界，能自主理解玩家指令、规划行动并与环境交互，比如采集资源、合成物品、跟随玩家、探索地形甚至战斗。项目解决的核心问题是：把 LLM 的推理与规划能力落地到具体游戏场景中，而不是停留在文本问答。核心能力包括自然语言对话控制、任务分解与执行、记忆与上下文管理、多机器人协作，以及可切换多种模型后端。它适合研究 AI Agent、具身智能和游戏自动化的开发者，也可作为教学演示，直观展示 LLM 如何在动态环境中感知、决策和行动。

开源 free 行业应用

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5844

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类行业应用

开发团队mindcraft-bots

所属国家

官网地址

GitHubhttps://github.com/mindcraft-bots/mindcraft

定价模式free

价格说明开源免费，需自备LLM API密钥

访问状态

是否开源是

开源协议MIT

主要语言JavaScript

技术栈/模型

GitHub 星标★ 5844

30天Star增速

HF 下载量

上线时间2023-08-16 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-06

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

Minecraft Java Edition（最高支持 v1.21.11，推荐 v1.21.6）
已安装 Node.js（npm 可用）
一个可用的大模型 API Key（只需一个）
本地存档世界已开启局域网（LAN）并监听 55916 端口

安装与启动步骤

1获取项目代码

下载最新 release 解压，或克隆仓库；两种方式任选其一即可。
```
git clone https://github.com/mindcraft-bots/mindcraft.git
cd mindcraft
```
2填写 API Key

把 keys.example.json 重命名为 keys.json，填入你的 API Key，只需填一个。要用的模型在 andy.json 或其他 profile 中设置。
```
mv keys.example.json keys.json
```
3安装依赖

在项目目录下执行 npm install，安装 Mineflayer 等 Node 依赖。
```
npm install
```
4开放游戏局域网

启动一个 Minecraft 世界，在游戏内对局域网开放，端口设置为 55916。
5启动机器人

在项目目录运行 node main.js，机器人会连入 55916 端口的本地世界。
```
node main.js
```

6（可选）Docker 运行

打算开启代码执行时，建议用 Docker 降低风险；注意本地服务器地址要写 host.docker.internal。

docker build -t mindcraft . && docker run --rm --add-host=host.docker.internal:host-gateway -p 8080:8080 -p 3000-3003:3000-3003 -e SETTINGS_JSON='{"auto_open_ui":false,"profiles":["./profiles/gemini.json"],"host":"host.docker.internal"}' --volume ./keys.json:/app/keys.json --name mindcraft mindcraft

关键配置

配置项	必填	说明	示例
`keys.json`	是	存放所使用模型后端的 API Key，至少填一个	`sk-xxxxxxxx`
`settings.js 的 allow_insecure_coding`	否	是否允许 LLM 写并执行代码，默认关闭，开启有注入风险	`true`
`settings.js 的 host`	否	Minecraft 服务器地址，Docker 内需改为 host.docker.internal	`host.docker.internal`
`andy.json / profiles 下的模型配置`	否	指定机器人使用的模型与 profile 文件	`./profiles/gemini.json`

如何确认成功

执行 node main.js 后终端正常输出运行日志且无报错，游戏内机器人按设定名称加入已开放局域网的世界并响应聊天指令。

常见问题

Q：Docker 里机器人连不上本地 Minecraft 服务器？

A：容器内不能用 localhost，需要把 settings.js 中的 host 改为 host.docker.internal；运行命令里已通过 --add-host 做主机映射。

Q：需要准备几个 API Key？

A：只需要一个。把 keys.example.json 改名为 keys.json 后填入对应后端的一个 Key 即可，模型在 andy.json 等 profile 中指定。

Q：支持哪些 Minecraft 版本？

A：最高支持到 v1.21.11，官方推荐 v1.21.6。要连接不受支持的版本，可尝试使用 services/viaproxy。

Q：开启代码执行安全吗？

A：allow_insecure_coding 默认关闭。代码虽在沙箱中执行，仍可能被注入攻击，开启前强烈建议放入 Docker 容器运行。

注意事项

切勿在开启代码执行的情况下把机器人连接到公共服务器，存在被注入攻击的风险。
Docker 方式运行需通过 --volume ./keys.json:/app/keys.json 把密钥文件挂载进容器。
游戏内必须把世界开放到局域网并使用 55916 端口，否则机器人无法连接。
遇到问题优先查阅项目 FAQ 文档或 Discord 支持频道，作者对 GitHub issue 响应较慢。

核心亮点

支持多种 LLM 后端，可自由切换模型和 API
基于 Mineflayer，机器人能真实执行采集、合成、战斗等游戏动作
提供记忆与任务规划机制，AI 能记住上下文并分解复杂指令

不足之处

依赖外部 LLM API，运行成本和延迟受模型服务影响
复杂任务下 AI 行为稳定性有限，可能出现卡住或误操作
配置和调试门槛偏高，对新手不够友好

适用场景

研究 LLM Agent 在开放世界中的规划与执行能力
直播或视频演示 AI 自主玩《我的世界》
作为教学案例讲解具身智能与游戏 AI

替代项目

Voyager、MineDojo

项目介绍

mindcraft 是行业应用领域的开源项目，由 mindcraft-bots 开发，2023 年首次发布。

在全站 13,752 个收录项目中，它的 GitHub 星标数（5,844）位列前 8%，在行业应用分类的 598 个项目里位列前 6%。

项目目前处于活跃维护状态，最近一次代码更新于 2026-10-03。开源免费，需自备LLM API密钥。

它主要面向的使用场景是：研究LLMAgent在开放世界中的规划与执行能力。同类可对比的替代方案包括 Voyager、MineDojo。

上一篇：omniscient

下一篇：book-translator