Mindcraft – 用LLM+Mineflayer打造Minecraft AI

Mindcraft 是一個開源項目，旨在將大型語言模型（LLM）與 Mineflayer（一個 Node.js 的 Minecraft 機器人庫）相結合，為《我的世界》（Minecraft）創造智能的 AI 代理。該項目由多位開發者貢獻，並有一篇相關研究論文《Collaborating Action by Action: A Multi-agent LLM Framework for Embodied Reasoning》。

核心功能

Mindcraft 允許玩家通過配置不同的 LLM 模型（如 GPT、Gemini、Claude 等）來驅動 Minecraft 中的機器人。機器人能夠理解自然語言指令，執行任務（如收集木材、合成物品），甚至進行對話。項目支持多種 API 提供商，包括 OpenAI、Google、Anthropic、DeepSeek、Ollama 等，用户只需在配置文件中填入相應的 API 密鑰即可使用。

安全警告

由於 LLM 能夠生成並執行代碼，項目默認禁用代碼寫入功能。用户如需啓用，必須在 settings.js 中將 allow_insecure_coding 設置為 true，並理解其中的安全風險。開發者強烈建議在 Docker 容器中運行項目以降低風險，同時強調即使在 Docker 中也不完全保證安全。

快速開始

1. 確保已安裝 Minecraft Java 版（最高支持 1.21.11，推薦 1.21.6）以及 Node.js（推薦 v18 或 v20 LTS）。
2. 下載最新發布版或克隆倉庫，重命名 keys.example.json 為 keys.json 並填入 API 密鑰。
3. 運行 npm install 安裝依賴，然後在遊戲中開啓 LAN 服務器（默認端口 55916）。
4. 執行 node main.js 啓動機器人。

任務系統

Mindcraft 支持通過 JSON 配置文件定義自動化任務。例如，可以讓機器人收集 4 個橡木原木：

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

任務文件可指定目標物品、初始庫存、超時時間等參數。更復雜的任務可參考 Minecollab 指導。

自定義與擴展

用户可以通過編輯 andy.json 等配置文件來調整機器人的名稱、模型、提示詞以及行為。支持為聊天、代碼生成、視覺、嵌入和語音合成分別指定不同的模型。項目還提供了 Dockerfile 和 docker-compose.yml 以便容器化部署。

社區與貢獻

項目在 GitHub 上開源，擁有超過 5400 顆星和 838 個分支。開發者鼓勵通過 Pull Request 貢獻代碼，但在 GitHub 上提交 Issue 可能響應較慢，更推薦加入 Discord 社區獲取支持。

Mindcraft 為 Minecraft 玩家和 AI 愛好者提供了一個探索 LLM 在遊戲環境中應用的絕佳平台，無論是學術研究還是趣味實驗，都具有很高的價值。