Mindcraft：接入大模型后，这个 Minecraft AI 代理会自己砍树挖矿

Mindcraft：接入大模型后，这个 Minecraft AI 代理会自己砍树挖矿

【免费下载链接】mindcraftMinecraft AI with LLMs+Mineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraft

接上 OpenAI，你在聊天框打一句"去挖铁"，游戏里的机器人会自己找镐子、砍树、往矿洞走——这就是 Mindcraft 干的事：它把大语言模型接进 Minecraft，让 LLM 扮演一个能聊天、能领任务、能动手干活的玩家。

🏃 5 步跑通本地 Minecraft AI 代理

先看三样东西齐不齐：Minecraft Java 版（支持到 v1.21.11，推荐 v1.21.6）、Node.js（v18 或 v20 LTS）、任意一家模型服务的 API 密钥（OpenAI、Gemini、Claude 等，只需要一个）。

齐了就开始：

git clone https://gitcode.com/GitHub_Trending/mi/mindcraft cd mindcraft && npm install

把keys.example.json重命名为keys.json填好密钥；开一个世界并打开局域网，端口用 55916（和settings.js里的port一致）；最后：

node main.js

机器人进场，游戏里 @ 它说话即可。这一段就是浓缩版的 Mindcraft 安装教程。

⛏️ 看 LLM 玩 Minecraft：三个真实场景

在聊天框直接指挥。代理的回复直接显示在 Minecraft 聊天栏，settings.js里把language改成中文，它就用中文跟你对话。

甩给它一个目标，自己干完。不用你一步步教，一条命令让它自动收集 4 块橡木原木：

node main.js --task_path tasks/basic/single_agent.json --task_id gather_oak_logs

它会自动决定砍树、收集、清点数量。仓库的tasks/目录下还有烹饪、建筑、合成三类预置任务，建筑任务甚至带图纸（blueprint），代理照着图纸放方块。

让它"看"画面。settings.js里allow_vision默认关闭；打开后，代理会用视觉模型解析自己视角的截图作为输入，判断环境更准。

⚙️ 换模型只改一个 json：settings.js 和 profiles 各管什么

settings.js管全局：连哪台服务器（host/port）、认证方式（auth选 offline 或 microsoft）、启用哪些代理、各类开关。代理名单就在profiles字段里，默认只加载根目录的andy.json。

profiles/目录（以及根目录andy.json）管每个代理：它的名字、用哪个模型、行为提示词和示例。比如andy.json里只有一行"model": "gpt-5.4-mini"，想换 Gemini 就改成"gemini-2.5-pro"并在keys.json里备着对应密钥。同一个 json 里还可以把code_model、vision_model、embedding、speak_model拆开，让聊天用一个模型、写代码用另一个。

🚧 避坑手册：三个高频现象

• 现象：机器人一直连不上。原因：局域网端口和settings.js的port不一致（默认 55916），或游戏版本不受支持。解法：两边端口对齐；版本对不上时可用仓库里的 viaproxy 服务过渡，或者用 1.21.6。

• 现象：机器人自己跟自己刷屏对话。原因：profile 里的名字和 Minecraft 档案名不一致。解法：改成完全一致。

• 现象：想让它自己写代码干活，又怕机器被搞坏。原因：代码执行开关allow_insecure_coding一旦打开，模型就能在你的电脑上生成并运行代码（有沙箱但仍可能被注入攻击）。解法：默认是false，不需要就别开；真要开，用docker-compose up跑在容器里，且不要连公开服务器。

• 现象：对话卡、上下文丢。原因：上下文由max_messages控制（默认 15 条），模型响应慢也会拖节奏。解法：日常闲聊换响应快的模型，复杂任务再上大模型。

进阶入口

• 多代理协作：node main.js --profiles ./profiles/andy.json ./profiles/jill.json拉两个代理进同一个世界（游戏里要/msg分别跟它们说话），tasks/里有人机协作的现成任务。
• 自定义技能：动作与技能库在src/agent/library/，加新动作就改这里；代理主循环在src/agent/agent.js。

下一步建议：先跑一遍gather_oak_logs任务，看它自己找木头；跑通了就加一个第二个 profile，让两个代理同时在你的局域网世界里干活。

【免费下载链接】mindcraftMinecraft AI with LLMs+Mineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraft