- 版权类型
- 原创
- 插件中文名称
- ExAI助手
- 插件英文名称
- ExAI
- 原帖地址
- 无
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
ExAI - Minecraft 智能助手插件
ExAI 是一款基于大语言模型的 Minecraft 服务器 AI 助手插件。通过自动上传以及对话监听快速建立服务器知识库，通过RAG技术能针对你的服务器内容给出精准回答。所有操作都在箱子 GUI 中完成，玩家无需记忆指令。
项目地址：https://github.com/Crossroadscodes/MC-ExAI
功能特性
- 箱子 GUI 对话 — 玩家通过菜单与助手单轮对话，不污染公屏。
- 公屏自动回答 — 检测疑问关键词触发，可配置冷却。
- 自动知识搜集 — 自动搜集公屏玩家之间的问答对，经过AI及管理员审核后上传知识库。
- 玩家知识上传 — 玩家用成书提交 Q&A → 管理员 在 GUI 中审批 → 通过后写入向量库。
- 奖励系统 — 审核通过自动发放 Vault 货币与自定义物品。
- RAG 语义检索 — 使用 DashScope text-embedding-v3（1024 维），相似度阈值可调。
- 管理员工具 — 聊天记录查看、知识库编辑、对话记录一键提升为知识。
- 灵活存储 — 通过 storage.type 在 MySQL 与纯本地 YAML 之间切换，小服可零数据库部署。
- 大模型后端 — 兼容 OpenAI 接口（默认阿里云 DashScope/通义千问，可替换为 OpenAI、DeepSeek 等）。
- 低成本 — 通过CD设置和输出截断实现了较低的AI调用成本。
界面预览
主菜单 — 开始对话将鼠标悬停到玩家头像上点击，即可进入单轮对话。
主菜单 — 单轮对话须知纸张物品显示使用说明与当前冷却时间。
主菜单 — 上传知识点击书本获取可编辑成书，按"问：xxx 答：yyy"格式填写后关闭书本即可提交审核。
主菜单 — 审核员审核（OP）打开分页审核界面：左键批准（自动写入知识库并发放奖励），右键拒绝。
主菜单 — 历史对话（OP）浏览玩家提问与 AI 回复历史：左键可编辑后晋升为正式知识，右键删除该记录。
主菜单 — 知识库管理（OP）查看并编辑所有已批准的知识条目：左键修改、右键删除，知识库自动重载。
公屏对话演示玩家在公屏输入带关键词（吗、怎么、？ 等）的问题，助手会在公屏自动回答。
指令与权限
| 指令 | 说明 |
| /exai opengui | 打开助手界面 |
| /exai question <玩家> <问题> | 向玩家发送问题（OP） |
| /exai reload | 重载配置（OP） |
| /exai help | 显示帮助 |
快速部署
- 将 ExAI.jar 放入 plugins/。
- 启动服务器一次，编辑 plugins/ExAI/config.yml：
- 选择 storage.type：yml（默认，无需数据库）或 mysql。
- 若为 mysql，填写 MySQL 连接信息。
- 填写大模型 API Key（llm.apiKey）。
- 自定义助手名称、语言、奖励配置。
- （可选）编辑 plugins/ExAI/knowledge.yml 预置知识库内容。
- 执行 /exai reload。
存储模式
| storage.type | 数据落地位置 |
| yml（默认） | knowledge.yml + data/ai_log.yml + data/pending_knowledge.yml + data/pending_count.yml |
| mysql | knowledge.yml（始终本地） + MySQL 表 ex_ai_log、ex_pending_knowledge、ex_pending_knowledge_count |
环境要求
- Spigot/Paper 1.12.2 或兼容版本
- Java 8+
- MySQL 5.7+ —— 仅 storage.type: mysql 时需要
- Vault —— 可选，用于发放货币奖励
- 一个兼容 OpenAI 协议的 LLM 接口 + Embedding 接口
Feedback & issues welcome. / 欢迎反馈与建议。
