Dwinovo/minecraft-numen

解決的問題

Numen 為 Minecraft 提供了一個 AI 同伴，能夠理解並執行以自然語言描述的複雜任務。與簡單的聊天 NPC 不同，它作為伺服器上的真實玩家運作，能夠執行採礦、建造、戰鬥等物理操作，透過高階指令有效自動化繁瑣的遊戲任務。

工作原理

該系統將 AI 同伴視為一個 ServerPlayer（伺服器端的虛擬玩家），確保其遵循與人類玩家相同的規則。系統透過一個包含四個組件的反饋循環運作：

• 身體：伺服器端的玩家實體，執行移動和互動的原生遊戲程式碼路徑。
• 眼睛（感知 API）：掃描方塊、實體和配方，無需開啟 GUI 即可檢查機器內容。
• 雙手（動作 API）：處理移動、採礦、放置方塊、戰鬥和倉儲管理。
• 反饋循環：每個動作的成功或失敗都會回饋給 LLM，使 AI 能夠即時學習並調整策略（例如，學習到鐵礦石需要石製鎬）。

"大腦" 運行在使用者自己的機器上，使用使用者自己的 API 金鑰，透過直接連接支援多種 LLM 提供商（OpenAI、Claude、DeepSeek 等）。

適用對象

• 希望獲得智能助手協助資源採集或基地建設的 Minecraft 玩家。
• 希望透過提供的 API 和插件系統將 AI 功能整合到自己模組中的模組開發者。
• 希望透過 Model Context Protocol (MCP) 實驗，使用 Claude Desktop 或 Cursor 等外部 AI 客戶端控制遊戲世界的 AI 愛好者。

主要亮點

• 自然語言控制：支援多語言的文本和語音輸入/輸出。
• 原生整合：作為真實玩家運作，與紅石、怪物 AI 及其他模組相容。
• 可擴展知識：可透過簡單的 Markdown 檔案（"技能"）或專用 Java 插件教授新的遊戲機制或模組特定工作流程。
• 支援 MCP：可作為 MCP 伺服器，允許外部 AI 客戶端驅動遊戲內同伴。
• 伺服器端執行：動作由伺服器驗證，適用於多人環境。