Mindcraft 快速入门指南用 LLM 驱动你的 Minecraft AI 代理【免费下载链接】mindcraftMinecraft AI with LLMsMineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraftMindcraft 是基于 LLM 和 Mineflayer 构建的 Minecraft AI 代理框架你可以用自然语言跟游戏里的代理聊天让它自己收集材料、烹饪、盖房子。这篇 Mindcraft 入门教程带你完成安装、配置与模型调优。 能玩出什么花样对代理说建个小木屋它会自己捡材料、找块空地、逐块放方块直到房子成型。这是建造场景也是它最拿手的事。想吃一顿熟饭就给它一个食物目标它会出门找食材用熔炉或工作台再把成品交到你手上。无聊的时候在聊天框里发一句话它会自然地接上话聊周围有什么甚至和其他玩家商量下一步干什么。tasks/ 目录里还预置了 JSON 格式的任务建造、烹饪、合成三类都有现成的。值得知道的是代理内部的分工它的身体跑在 Mineflayer 库上负责接入游戏世界、执行移动、挖掘、放置方块这些操作脑子则是大语言模型负责听懂你说的话并决定接下来做什么。两者组合起来才是一个完整的 Minecraft AI 代理。五分钟跑通 Mindcraft动手前先确认三件事你装了 Minecraft Java Edition推荐 v1.21.1装好 Node.js v18 或更高版本手里至少有一个大模型 API 密钥OpenAI、Gemini、Claude 任选其一。然后按顺序来。克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/mi/mindcraft cd mindcraft npm install接着把 keys.example.json 复制成 keys.json填入你有的那个密钥即可只需要一个。之后打开一个 Minecraft 世界开启局域网并设置端口为 55916回到终端执行node main.js看到代理走进你的世界就可以开始聊天了。它是怎么思考的代理的核心逻辑在 src/agent/ 目录下可以按四层来理解。大脑是 LLM也就是配置文件里的 model 字段负责对话与决策。记忆是 memory_bank.js存放代理需要记住的信息可以跨会话加载。手脚是 action_manager把大脑想出来的东西翻译成具体的游戏操作比如走到某个坐标、挖掉一个方块、放下一块方块。技能库是 skills.js它定义了代理能调用哪些命令代理看到的提示词就是围绕这些技能拼出来的。一句话概括LLM 管想记忆管记action 管做技能库管你被允许做什么。怎么调教它配置分两层。根目录的 settings.js 管全局服务器连接的主机、端口、认证方式代码执行的安全开关以及上下文消息条数这类性能参数。profiles/ 目录管单个代理每个 json 文件定义一个代理的名字、模型和提示词里面预置了 gpt.json、claude.json、gemini.json 等按需选用根目录的 andy.json 是默认配置。选模型时看任务定。日常闲聊用轻量模型就够了响应快、开销小跑建筑、合成这种复杂多步任务再上强模型否则它中途容易丢三落四。嫌响应慢除了换模型还可以开启嵌入缓存、调整 settings.js 里的超时与上下文条数提示词示例也值得花时间打磨它对代理行为的影响很直接。 再往深处玩先说安全Mindcraft 允许 LLM 在你的电脑上写 JavaScript 代码并执行这个功能默认关闭。如果你确要启用 allow_insecure_coding把它在 settings.js 里设为 true 之前务必先用 Docker 跑项目并且绝对不要把它连到公共服务器。想清楚这一点进阶玩法就顺了多代理协作node main.js --profiles ./profiles/andy.json ./profiles/jill.json一次传入多个配置多个代理同时进世界各带各的脑子。视觉理解src/agent/vision/ 模块让代理能解读游戏画面截图环境感知不再只靠文字描述。自定义技能修改 skills.js 里的定义或者新建动作模板就能给代理加上新的能力。Docker 部署docker-compose up一条命令即可启动这也是承载代码执行风险最稳妥的方式。排错速查连不上世界先查局域网端口是不是 55916再查 settings.js 里的 host 和 port 是否对得上顺便确认 Minecraft 版本受支持、防火墙没有拦截连接。密钥无效或模型报错检查 keys.json 里密钥是否填对、额度是否还有余量以及 profile 里选的模型是否属于你持有密钥的那家服务商。响应太慢换更轻量的模型调整 settings.js 里的超时设置再检查网络还是不行就翻一翻仓库里的 FAQ.md常见问题都有。写在最后Mindcraft 采用模块化设计新增模型或功能并不困难社区欢迎代码贡献和各类建议。它同时也是研究多智能体系统与具身推理时可以动手的平台。如果你打算深入从 src/ 下的源码和 settings.js 的配置读起是最快的路。【免费下载链接】mindcraftMinecraft AI with LLMsMineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考