ExAI - Minecraft 智能助手插件

ExAI 是一款基于大语言模型的 Minecraft 服务器 AI 助手插件。结合 RAG（向量检索 + LLM）与社区共建的知识库，能针对你的服务器内容给出精准回答。所有操作都在箱子 GUI 中完成，玩家无需记忆指令。

功能特性

• 箱子 GUI 对话 — 玩家通过菜单与助手单轮对话，不污染公屏。
• 公屏自动回答 — 检测疑问关键词触发，可配置冷却。
• 知识库审核流程 — 玩家用成书提交 Q&A → OP 在 GUI 中审批 → 通过后写入向量库。
• RAG 语义检索 — 使用 DashScope text-embedding-v3（1024 维），相似度阈值可调。
• 奖励系统 — 审核通过自动发放 Vault 货币与自定义物品。
• 管理员工具 — 聊天记录查看、知识库编辑、对话记录一键提升为知识。
• 灵活存储 — 通过 storage.type 在 MySQL 与纯本地 YAML 之间切换，小服可零数据库部署。
• 国际化 — 内置 zh_CN / en_US，支持热重载。
• 大模型后端 — 兼容 OpenAI 接口（默认阿里云 DashScope/通义千问，可替换为 OpenAI、DeepSeek 等）。

指令与权限

指令 说明 /exai opengui 打开助手界面 /exai question <玩家> <问题> 向玩家发送问题（OP） /exai reload 重载配置（OP） /exai help 显示帮助 权限节点：exai.op（知识审核）。

快速部署

1. 将 ExAI.jar 放入 plugins/。
2. 启动服务器一次，编辑 plugins/ExAI/config.yml：
3. 选择 storage.type：yml（默认，无需数据库）或 mysql。
4. 若为 mysql，填写 MySQL 连接信息。
5. 填写大模型 API Key（llm.apiKey）。
6. 自定义助手名称、语言、奖励配置。
7. （可选）编辑 plugins/ExAI/knowledge.yml 预置知识库内容。
8. 执行 /exai reload。

存储模式

yml（默认）
mysql

环境要求

• Spigot/Paper 1.12.2 或兼容版本
• Java 8+
• MySQL 5.7+ —— 仅 storage.type: mysql 时需要
• Vault —— 可选，用于发放货币奖励
• 一个兼容 OpenAI 协议的 LLM 接口 + Embedding 接口

项目地址：https://github.com/Crossroadscodes/MC-ExAI/ 欢迎反馈与建议。