Mindcraft 实战LLM 驱动 Minecraft 代理【免费下载链接】mindcraftMinecraft AI with LLMsMineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraftMindcraft 是一个把大语言模型接入 Minecraft 的开源项目底层依赖 Mineflayer 让 AI 角色真正进游戏听懂聊天指令调用内置技能或自己写代码完成采集、合成、建造。适合想研究 LLM 具身智能和多智能体协作的开发者。Mindcraft 解决什么问题Mineflayer 这类库能把机器人开进 Minecraft但听懂人话的部分得自己写解析聊天、决定下一步动作、维护背包和寻路用规则很难覆盖自然语言的各种表达。另一方面大模型只能输出文字没有手可以操作游戏。Mindcraft 把这两端接起来——你在游戏聊天框里说帮我拿四根橡木代理会调用内置技能或生成代码去执行完成后把结果回报到聊天里。环境准备与最短安装路径前置条件Minecraft Java Edition最高支持 1.21.11官方推荐 1.21.6Node.js v18 或 v20 LTSv24 会导致原生模块构建失败至少一个受支持的 LLM API 密钥默认 OpenAI只需填一个Windows 安装 Node 时勾选 Automatically install the necessary tools编译原生依赖需要安装步骤git clone https://gitcode.com/GitHub_Trending/mi/mindcraft cd mindcraft获取完整源码npm install装依赖postinstall 会自动应用 patches 目录下的补丁cp keys.example.json keys.json把密钥填入新文件模型鉴权用在游戏里创建世界并对局域网开放端口指定 55916给机器人留连接入口。node main.js启动代理浏览器自动打开 8080 控制台运行后你会看到机器人 andy 生成进世界名字和模型由根目录 andy.json 定义并在游戏聊天里回出 settings.js 中 init_message 的内容此时你直接在聊天框输入指令就能和它互动。核心能力拆解与源码位置多代理协作——--profiles传入多个配置文件同一世界生成多个机器人它们会在聊天里分工、互赠物品 —— profiles/任务驱动评测—— 一条命令载入任务 JSON代理自动开局按目标物品数量判定成败超时自动退出并输出结果 —— tasks/代码生成执行—— 开启allow_insecure_coding后模型可以为新动作编写并运行 JS覆盖模板技能做不到的操作默认关闭—— src/agent/coder.js视觉理解—— 开启allow_vision后游戏画面截图交给视觉模型转成文字描述注入上下文供决策默认关闭—— src/agent/vision/实战跑通一个最小烹饪场景下面跑一个与示例不同的双代理协作任务两个代理分工做出熟鸡肉和金胡萝卜。世界沿用之前局域网打开的那个端口 55916。settings.js 保持默认即可任务命令会自行注入目标、初始背包和 promptnode main.js --task_path tasks/cooking_tasks/require_collab_train_2_items/2_agent.json \ --task_id multiagent_cooking_2_1_cooked_chicken_1_golden_carrot预期看到两个代理生成后先在聊天里对齐分工——0 号拿到的初始背包里有 1 个煤炭负责杀鸡、放炉子煮熟鸡肉1 号有 4 个金锭负责把金锭炼成金粒、再拿胡萝卜围一圈合成金胡萝卜。两件目标物品集齐后 episode 结束、代理自动离开游戏未完成则 500 秒超时退出。常见卡点现象、原因与排查现象启动后终端报Error: connect ECONNREFUSED原因Minecraft 没有开局域网或 LAN 端口与 settings.js 中 port 不一致解法游戏内对局域网开放时指定 55916与 settings.js 的 port 保持同值现象npm install报 Python 缺失或 C20 编译错误原因原生模块 gl 在当前 Node 版本下构建失败多见于 v24解法nvm use 20后重装不用视觉功能可执行npm install --no-optional跳过 gl现象配了密钥仍提示找不到 key或运行时报 My brain disconnected原因文件仍叫 keys.example.json、编辑后未保存或密钥与 profile 中的 api 不匹配解法确认已改名为 keys.json 并保存核对 andy.json 的 model 前缀与密钥对应现象机器人频繁卡在原地不动原因mineflayer-pathfinder 的补丁未正确生效解法更新代码后删除 node_modules 重新npm install让 patch-package 重新打补丁下一步该读哪些源码与配置settings.js —— 连接地址、端口、是否允许代码执行和视觉、上下文长度等全局开关都在这想改行为先看它src/agent/ —— 代理主循环agent.js、代码生成coder.js、技能库library/skills.js在这条链路里加自定义动作时按此顺序读minecollab.md —— 烹饪、建造、合成三类任务的结构与评测方式想复现多智能体协作实验从这里入手建议先按上一节把双代理烹饪任务跑通确认聊天、移动、合成链路都正常再去动 settings.js 和 profile。之后想换模型只改 profile 里的 model 字段并配好对应密钥即可。【免费下载链接】mindcraftMinecraft AI with LLMsMineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考