LLMChat

<div align="center"> # LLMChat <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/SodiumSulfate/LLMChat/main/docs/head.png" /> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/SodiumSulfate/LLMChat/main/docs/head.png" /> <img width="85%" src="https://raw.githubusercontent.com/SodiumSulfate/LLMChat/main/docs/head.png" alt="LLMChat Banner" /> </picture> <p align="center"> <span style="font-size: 0.75em; color: #888;">图片由 Gemini Nano Banana 2 生成</span> </p> **一个强大的 Minecraft 服务器 AI 聊天插件** 让玩家在游戏中与各种大语言模型 (LLM) 进行对话 (https://img.shields.io/badge/Java-21-orange?style=flat-square&logo=openjdk&logoColor=white)](https://openjdk.org/) (https://img.shields.io/badge/Minecraft-1.20%2B-green?style=flat-square&logo=minecraft&logoColor=white)](https://www.minecraft.net/) (https://img.shields.io/badge/License-GPL%20v3-blue?style=flat-square)](./LICENSE) (https://img.shields.io/badge/Version-1.1-brightgreen?style=flat-square)](https://github.com/SodiumSulfate/LLMChat/releases) (https://img.shields.io/badge/作者官网-sodium.ren-blue?style=flat-square&logo=google-chrome&logoColor=white)](https://sodium.ren/) (#english) | (#中文文档) | (https://sodium.ren/) --- ### Github (https://img.shields.io/badge/GitHub-LLMChat-181717?logo=github&style=for-the-badge)](https://github.com/SodiumSulfate/LLMChat) --- </div> ## 中文文档 ### 简介 你是否想过让 Minecraft 服务器中的玩家能够直接与 AI 对话？LLMChat 让这一切变得简单。 LLMChat 是一个为 Minecraft 服务器设计的 AI 聊天插件，支持多种大语言模型 API，让玩家可以在游戏中与 AI 进行自然对话。无论是回答游戏问题、提供服务器帮助，还是简单的闲聊，LLMChat 都能胜任。 > > 支持所有兼容 OpenAI API 格式的服务，包括 OpenAI、SiliconFlow、DeepSeek、Azure OpenAI 等。 ### 功能特性 | 特性 | 描述 | |:----:|:-----| | 🔌 **多 API 支持** | 同时配置多个 LLM API（如 OpenAI、SiliconFlow 等） | | 🎭 **多模型选择** | 每个 API 可配置多个模型，玩家可自由选择 | | ⌨️ **灵活命令** | 支持指定 API 和模型进行对话 | | ⏱️ **冷却管理** | 可配置的请求频率限制，防止 API 滥用 | | 📋 **白名单系统** | 特定玩家可绕过冷却限制 | | 📝 **聊天日志** | 自动记录所有对话，按日期分文件存储 | | 🩺 **健康检查** | 控制台命令检查所有 API 和模型的可用性 | | 🔄 **热重载** | 无需重启服务器即可重新加载配置 | | 🔒 **安全设计** | 强制 HTTPS 连接，敏感信息自动脱敏 | ### 环境要求 | 依赖 | 版本要求 | |:----:|:--------:| | Minecraft Server | Paper 1.20+ (或 Spigot/Bukkit 兼容) | | Java | 21 或更高版本 | ### 安装 1. 从 (https://github.com/SodiumSulfate/LLMChat/releases) 页面下载最新的 `LLMChat-x.x.jar` 2. 将 jar 文件放入服务器的 `plugins` 目录 3. 启动服务器，插件会自动生成配置文件 4. 编辑 `plugins/LLMChat-Sodium_Sulfate/config.yml` 配置你的 API 5. 使用 `/llmchat reload` 重载配置（控制台） > > 请勿将包含真实 API Key 的 `config.yml` 上传到公开仓库！ ### 配置说明 ```yaml # 默认使用的 API default_api: "siliconflow" # 帮助信息（支持 Minecraft 颜色代码） help_message: - "&e========== LLMChat 帮助 ==========" - "&b/llmchat <消息> &7- 使用默认API和模型与AI对话" - "&b/llmchat -api:<名称> <消息> &7- 使用指定API" - "&b/llmchat -model:<名称> <消息> &7- 使用指定模型" - "&e==================================" # 冷却时间配置 cooldown: whitelist: # 绕过冷却的玩家列表 - "admin" default: # 默认冷却设置 max_requests_per_minute: 5 cooldown_seconds: 60 models: # 特定模型的冷却设置 qwen: max_requests_per_minute: 10 cooldown_seconds: 30 # API 配置 apis: siliconflow: url: "https://api.siliconflow.cn/v1/chat/completions" api_key: "YOUR_API_KEY" default_model: "qwen" system_prompt: "你是Minecraft服务器中的AI助手，说话简短（不超过80字），用中文回答。" models: qwen: model_id: "Qwen/Qwen3-8B" deepseek: model_id: "deepseek-ai/DeepSeek-V3" ``` ### 命令 | 命令 | 描述 | 权限 | |:-----|:-----|:----:| | `/llmchat <消息>` | 使用默认 API 和模型对话 | `llmchat.use` | | `/llmchat -api:<名称> <消息>` | 使用指定 API 对话 | `llmchat.use` | | `/llmchat -model:<名称> <消息>` | 使用指定模型对话 | `llmchat.use` | | `/llmchat -api:<名称> -model:<名称> <消息>` | 同时指定 API 和模型 | `llmchat.use` | | `/llmchat list` | 列出所有可用的 API 和模型 | `llmchat.list` | | `/llmchat help` | 显示帮助信息 | - | | `/llmchat check` | 检查所有 API 可用性（仅控制台） | `llmchat.admin` | | `/llmchat reload` | 重载配置（仅控制台） | `llmchat.admin` | ### 权限 | 权限 | 描述 | 默认 | |:-----|:-----|:----:| | `llmchat.use` | 使用 AI 对话功能 | 所有人 | | `llmchat.list` | 查看 API 和模型列表 | 所有人 | | `llmchat.admin` | 管理员命令 (reload, check) | OP | | `llmchat.bypass.cooldown` | 绕过冷却时间限制 | OP | | `llmchat.*` | 所有 LLMChat 权限 | OP | ### 支持的 API 服务 理论上支持所有兼容 OpenAI API 格式的服务： | 服务商 | 状态 | 备注 | |:-------|:----:|:-----| | (https://platform.openai.com/) | ✅ | GPT-3.5, GPT-4 | | (https://cloud.siliconflow.cn/) | ✅ | Qwen, DeepSeek 等 | | (https://www.deepseek.com/) | ✅ | DeepSeek 系列 | | (https://azure.microsoft.com/openai) | ✅ | 需配置正确的 endpoint | | (https://developers.cloudflare.com/workers-ai/) | ✅ | - | | (https://help.aliyun.com/document_detail/2400395.html) | ✅ | 阿里云 | | (https://bigmodel.cn) | ✅ | GLM 系列 | | (https://platform.moonshot.cn/) | ✅ | Kimi 系列 | | 其他 OpenAI 兼容 API | ✅ | 只需配置正确的 URL | ### 构建 ```bash # 克隆仓库 git clone https://github.com/SodiumSulfate/LLMChat.git cd LLMChat # 使用 Maven