Dwinovo/minecraft-numen

Numen is an embodied agent that runs inside Minecraft. It lives in the game as a mod, continually explores the Minecraft world, makes its own decisions, and takes action to get tasks done.

这是什么

Numen（中文：言出法随）是一个Minecraft模组，在游戏内直接嵌入具身AI代理。该代理作为玩家角色运行，感知世界，并可通过基于Lua的API由大语言模型（LLM）驱动。实际上，你安装模组、配置LLM服务（OpenAI、Anthropic或任何兼容API）、召唤一个机器人，然后用自然语言与它对话——它会决定做什么并执行Minecraft动作（移动、挖掘、建造、交互等）。

为什么重要

具身智能：与仅限聊天的机器人不同，该代理实际上会操作Minecraft世界，为LLM驱动的机器人和规划研究提供了具体的测试平台。
开源且可扩展：模组采用LGPL-3.0许可，并提供插件系统，使开发人员可以将新的Lua动作（例如来自其他模组的动作）暴露给LLM。
混合部署：您可以通过API密钥在本地运行LLM，或将模组连接到外部“MCP”大脑（Claude Code、Cursor等）在其他地方进行推理，从而节省令牌成本。

谁可能使用它

用户类型	他们能获得什么
Minecraft玩家	想要一个可以帮助建造、探索或自动执行任务的自动驾驶伙伴。
AI研究人员/爱好者	寻找一个沙盒来实验具身LLM代理、提示工程或多模态交互（语音、文本、皮肤定制）。
模组开发人员	想要让自己的模组被LLM控制——他们可以编写一个插件，注册新的Lua函数供代理调用。
教育工作者	在熟悉的游戏环境中演示感知-行动循环、规划或提示驱动机器人等概念。

如何入门

安装：从CurseForge（搜索“Numen”）为您使用的Minecraft版本（例如1.20.1-Fabric）安装模组。
进入游戏：按G（新版本为N）打开控制面板。
配置模型：选择OpenAI或Anthropic，粘贴您的API密钥，并可选地设置自定义“性格”或皮肤。
召唤机器人：给它一个名字，然后开始聊天。您可以用Y输入文字，用V说话，或用R+鼠标滚轮在多个机器人之间切换。
扩展：将插件放入plugins文件夹以暴露新的Lua动作（例如控制Touhou Little Maid模组）。请参阅仓库的plugins目录和网站文档中的模板。

技术亮点

三层架构：
1. Minecraft核心 – 代理控制真实的玩家实体。
2. Lua API – 一组原子动作（感知、移动、挖掘、建造、交互），可被LLM调用。有一个小型Java API用于加载技能。
3. LLM沙盒 – Lua脚本在沙盒内运行，在单次调用中协调许多原子动作。
模型无关：支持任何遵循OpenAI或Anthropic HTTP协议的服务；您只需输入端点URL。
MCP服务器模式：模组可以充当Minecraft-Chat-Protocol服务器，让外部AI客户端驱动代理，保持推理在设备外。
语音I/O：通过面板设置提供可选的语音输入/输出。
多代理聊天：将头像拖到一起创建群聊；@提及会定向回复。

社区与支持

QQ群：1121662678
Discord：https://discord.gg/FpDCV327vX
官方网站：https://numen.dwinovo.cn （文档、架构图、插件指南）
问题跟踪器：如有错误或功能请求，请使用GitHub Issues。

以上信息均直接取自仓库的README。