如何快速上手 Mindcraft：用大模型打造 Minecraft AI 代理的完整指南

如何快速上手 Mindcraft用大模型打造 Minecraft AI 代理的完整指南【免费下载链接】mindcraftMinecraft AI with LLMsMineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraftMindcraft 是一个把大语言模型LLM与 Minecraft 结合的开源框架基于 Mineflayer 机器人引擎让 AI 角色能进游戏聊天、收集资源、按蓝图建造。本指南面向零基础读者带你从零跑通第一个 AI 角色。 适合谁三种典型场景想要游戏伙伴的玩家开一个局域网世界让 AI 角色进服陪你挖矿聊天。想研究具身智能的开发者项目自带收集、合成、烹饪、建造等完整任务集也是已发表为学术基准的多代理研究平台。本地模型爱好者支持 Ollama 本地推理并提供官方微调好的模型可以完全离线跑。它开箱支持 OpenAI、Gemini、Claude、DeepSeek、Qwen、Mistral、Ollama 等 18 家以上的模型服务只需配置一个 API 密钥即可运行。⚡ 5 步跑通从克隆到 AI 入服先对好环境版本这是新手最容易踩的坑组件要求MinecraftJava Edition最高支持 1.21.11推荐 1.21.6Node.jsv18 或 v20 LTSv24 会报原生依赖编译错误API 密钥支持列表中的任意一家克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/mi/mindcraft cd mindcraft npm install把 keys.example.json 重命名为keys.json只填一家模型的密钥即可。启动 Minecraft把世界开放为局域网端口设置为55916。运行node main.js。角色出现后直接在游戏聊天框和它对话。默认加载根目录的 andy.json名字 andy 一个 OpenAI 模型启动后浏览器还会自动打开 8080 端口的管理界面。 新手最该知道的 4 个配置项settings.js 里选项不少初上手只需要动这几处host/port/auth连接目标。局域网默认127.0.0.155916 离线认证要连线上服务器则把auth改成microsoft填服务器地址和端口且代理名必须与 Minecraft 账号名完全一致。profiles代理配置文件列表。每个 profile 是个 JSON定义角色名、模型和提示词放多个文件就能同时拉起多个 AI。allow_insecure_coding允许模型在你机器上写并执行 JavaScript。默认关闭建议非 Docker 环境保持关闭。language对话语言默认英文。最简的代理 profile 只有名字和模型两行。profiles/ 目录里按各家模型做好了示例gpt、claude、gemini、qwen 等照抄改模型名就能用。 按场景拆解核心能力陪聊角色出生会发一条开场白游戏内聊天即回即答还能开关自动行为播报narrate_behavior。任务模式一条命令下达目标例如运行node main.js --task_path tasks/basic/single_agent.json --task_id gather_oak_logs代理会自己去找 4 根橡木原木超时自动离场。tasks/ 内置了收集、合成、烹饪、建造四类多代理任务集。多代理协作node main.js --profiles ./profiles/andy.json ./profiles/claude.json一次拉起两个角色之后用/msg单独对某个角色下达指令。视觉理解开启allow_vision后代理能看截图来理解环境render_bot_view则把机器人视角实时推到浏览器。本地模型装好 Ollama 后拉取官方微调模型sweaterdog/andy-4:micro-q8_0和嵌入模型embeddinggemma即可离线运行完整对话与示例检索。️ 进阶实践Docker 与安全让 LLM 写代码天然有注入风险官方明确警告不要开着代码执行连公共服务器。需要此功能时建议用容器隔离docker-compose up --build容器内要连本机游戏把host改成host.docker.internal即可。模型选择上有个实用经验日常对话用便宜快的小模型复杂建造任务再换强模型对延迟敏感就优先 Ollama 本地部署。 常见卡点连接不上的排查顺序ECONNREFUSED连不上游戏依次确认——世界是否已开放为局域网游戏里填的端口和配置里port是否一致Minecraft 版本是否与配置匹配。npm install报 Python/C 错误原生模块编译问题。切到 Node v20 重装不用视觉功能可直接npm install --no-optional跳过出问题的依赖。提示 My brain disconnectedLLM API 侧问题检查密钥是否正确、额度是否用完再看终端日志细节。代理总卡住不动寻路库本身不完美。先更新代码、删除node_modules重装偶发卡住属正常持续卡住多半是补丁没打上。密钥找不到多半是忘了重命名keys.example.json或者编辑后没保存文件。更多问题mod 支持、材质包冲突等可查 FAQ.md。 跑通之后下一步去哪看跑一次多代理任务tasks/ 里的烹饪任务有个 Hells Kitchen 变体每个代理只拿到部分配方必须靠互相聊天补齐——很适合观察协作能力。读 minecollab.md 了解基准测试和自动启动流程。想改角色性格或加新技能从代理 profile 和 src/agent/ 入手。Mindcraft 的核心是LLM 机器人引擎 任务循环。把上面基础流程跑通后换模型、调提示词、加技能都可以自己发挥了。【免费下载链接】mindcraftMinecraft AI with LLMsMineflayer项目地址: https://gitcode.com/GitHub_Trending/mi/mindcraft创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考