LLMChat
图片由 Gemini Nano Banana 2 生成
一个强大的 Minecraft 服务器 AI 聊天插件
让玩家在游戏中与各种大语言模型 (LLM) 进行对话
Github
中文文档
简介
你是否想过让 Minecraft 服务器中的玩家能够直接与 AI 对话?LLMChat 让这一切变得简单。
LLMChat 是一个为 Minecraft 服务器设计的 AI 聊天插件,支持多种大语言模型 API,让玩家可以在游戏中与 AI 进行自然对话。无论是回答游戏问题、提供服务器帮助,还是简单的闲聊,LLMChat 都能胜任。
[!TIP] 支持所有兼容 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 或更高版本 |
安装
- 从 Releases 页面下载最新的
LLMChat-x.x.jar - 将 jar 文件放入服务器的
plugins目录 - 启动服务器,插件会自动生成配置文件
- 编辑
plugins/LLMChat-Sodium_Sulfate/config.yml配置你的 API - 使用
/llmchat reload重载配置(控制台)
[!WARNING] 请勿将包含真实 API Key 的
config.yml上传到公开仓库!
配置说明
# 默认使用的 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 格式的服务:
| 服务商 | 状态 | 备注 |
|---|---|---|
| OpenAI | ✅ | GPT-3.5, GPT-4 |
| SiliconFlow | ✅ | Qwen, DeepSeek 等 |
| DeepSeek | ✅ | DeepSeek 系列 |
| Azure OpenAI | ✅ | 需配置正确的 endpoint |
| Cloudflare Workers AI | ✅ | - |
| 通义千问 | ✅ | 阿里云 |
| 智谱 AI | ✅ | GLM 系列 |
| Moonshot | ✅ | Kimi 系列 |
| 其他 OpenAI 兼容 API | ✅ | 只需配置正确的 URL |
构建
# 克隆仓库
git clone https://github.com/SodiumSulfate/LLMChat.git
cd LLMChat
# 使用 Maven 构建
mvn clean package
# 构建产物位于 target/LLMChat-x.x.jar
贡献指南
欢迎提交 Issue 和 Pull Request!
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
[!NOTE] 提交 PR 前请确保代码风格与现有代码一致,并通过编译测试。
许可证
本项目采用 GNU General Public License v3.0 开源协议。
重要条款:
- ✅ 可以自由使用、修改和分发
- ⚠️ 修改后的版本必须开源并以相同协议发布
- ⚠️ 引用或整合本代码的项目必须开源并以相同协议发布
- ⚠️ 必须保留原始版权声明和许可证
English
Introduction
Have you ever wanted players on your Minecraft server to chat directly with AI? LLMChat makes it simple.
LLMChat is an AI chat plugin designed for Minecraft servers, supporting multiple LLM APIs, allowing players to have natural conversations with AI in-game. Whether answering game questions, providing server help, or just casual chat, LLMChat handles it all.
[!TIP] 支持所有兼容 OpenAI API 的服务,包括 OpenAI、SiliconFlow、DeepSeek、Azure OpenAI 等。
功能特性
| 特性 | 描述 |
|---|---|
| ? 多 API 支持 | 同时配置多个大语言模型 API(OpenAI、SiliconFlow 等) |
| ? 多模型选择 | 每个 API 可配置多个模型供玩家选择 |
| ⌨️ 灵活指令 | 在对话中指定使用的 API 和模型 |
| ⏱️ 冷却管理 | 可配置的速率限制,防止滥用 API |
| ? 白名单系统 | 特定玩家可绕过冷却限制 |
| ? 聊天记录日志 | 自动记录对话,并按天轮转文件 |
| ? 健康检查 | 控制台命令,用于检查所有 API 和模型的可用性 |
| ? 热重载 | 无需重启服务器即可重新加载配置 |
| ? 安全设计 | 强制使用 HTTPS 连接,自动清理敏感数据 |
依赖要求
| 依赖项 | 版本 |
|---|---|
| Minecraft Server | Paper 1.20+(或兼容 Spigot/Bukkit) |
| Java | 21 或更高版本 |
安装步骤
- 从 Releases 下载最新的
LLMChat-x.x.jar - 将 jar 文件放入服务器的
plugins目录 - 启动服务器,插件将自动生成配置文件
- 编辑
plugins/LLMChat-Sodium_Sulfate/config.yml以配置你的 API - 使用
/llmchat reload重新加载配置(仅限控制台)
[!WARNING] 切勿将包含真实 API 密钥的
config.yml上传至公共仓库!
命令列表
| 命令 | 描述 | 权限 |
|---|---|---|
/llmchat <message> |
使用默认 API 和模型进行聊天 | llmchat.use |
/llmchat -api:<name> <message> |
使用指定的 API | llmchat.use |
/llmchat -model:<name> <message> |
使用指定的模型 | 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 的服务:
| 提供商 | 状态 | 备注 |
|---|---|---|
| OpenAI | ✅ | GPT-3.5, GPT-4 |
| SiliconFlow | ✅ | Qwen, DeepSeek 等 |
| DeepSeek | ✅ | DeepSeek 系列 |
| Azure OpenAI | ✅ | 需要配置正确的端点 |
| Cloudflare Workers AI | ✅ | - |
| 其他 OpenAI 兼容 API | ✅ | 只需配置正确的 URL 即可 |
构建方法
# 克隆仓库
git clone https://github.com/SodiumSulfate/LLMChat.git
cd LLMChat
# 使用 Maven 构建
mvn clean package
# 输出文件:target/LLMChat-x.x.jar
贡献指南
欢迎提交 Issue 和 Pull Request!
- Fork 本仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 创建 Pull Request
[!NOTE] 请在提交 PR 前确保代码风格与现有代码一致,并通过编译。
许可证
本项目采用 GNU General Public License v3.0 许可。
关键条款:
- ✅ 可免费使用、修改和分发
- ⚠️ 修改后的版本必须以相同许可证开源
- ⚠️ 使用或集成此代码的项目必须以相同许可证开源
- ⚠️ 必须保留原始版权声明和许可证
由 Sodium_Sulfate ❤️ 制作
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧