
mindcraft
用自然语言指挥 AI 在《我的世界》里干活
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-06 · 当前星标 ★ 6037
使用教程
环境要求
- 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
上一篇:omniscient
下一篇:book-translator
同类项目推荐
OlinkRPackage
开源
Olink蛋白组数据一键读入R并完成质控与差异分析
Olink R package: A collection of functions to facilitate analysis of proteomic data ···
ai-virtual-assistant
开源
搭个AI客服,自动答常见问题省人力
Customizable, AI-driven virtual assistant designed to streamline customer service op···
RTranslator
开源
手机本地实时翻译,不联网也能聊遍全球
Open source real-time translation app for Android that runs locally
phlox
开源
本地运行 AI 医疗助手,隐私安全问诊
Open source, local first AI medical agent for desktop and web.
odyssey
开源
用 EHR 数据快速训练医疗基础模型
An interpretable foundation model of the patient clinical timeline: event forecastin···
ContractGuard
开源
上传合同,秒懂风险条款,告别法律盲区。
AI agent that reads the fine print so you don't have to. Upload any contract → get ···
AI_SOC
开源
让 LLM 多智能体自动研判 Wazuh 告警,减少 SOC 人工翻日志
Open-source AI-augmented Security Operations Center using LLMs + Multi-Agent Orchest···
Awesome-Radiology-Report-Generat···
开源
一页找齐放射报告生成论文、数据集与指标
paper list, dataset, and tools for radiology report generation
GenAI4AD
开源
一张图看懂生成式AI如何重塑自动驾驶全栈
a comprehensive and critical synthesis of the emerging role of GenAI across the full···