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 客户端驱动游戏内同伴。
• 服务器端执行：动作由服务器验证，适用于多人环境。