LLMChat

插件

· 作者 Sodium_Sulfate

一个功能强大的 Minecraft AI 聊天插件,支持多种 LLM API

0 本站下载 0 关注 更新于 6 个月前

最新 1.2 · 1.21.11 · Bukkit / Folia

一键开服(送7天)

LLMChat

LLMChat Banner

图片由 Gemini Nano Banana 2 生成

一个强大的 Minecraft 服务器 AI 聊天插件

让玩家在游戏中与各种大语言模型 (LLM) 进行对话

English | 中文文档 | 作者官网


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 或更高版本

安装

  1. 从 Releases 页面下载最新的 LLMChat-x.x.jar
  2. 将 jar 文件放入服务器的 plugins 目录
  3. 启动服务器,插件会自动生成配置文件
  4. 编辑 plugins/LLMChat-Sodium_Sulfate/config.yml 配置你的 API
  5. 使用 /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!

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 创建 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 或更高版本

安装步骤

  1. 从 Releases 下载最新的 LLMChat-x.x.jar
  2. 将 jar 文件放入服务器的 plugins 目录
  3. 启动服务器,插件将自动生成配置文件
  4. 编辑 plugins/LLMChat-Sodium_Sulfate/config.yml 以配置你的 API
  5. 使用 /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!

  1. Fork 本仓库
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 创建 Pull Request

[!NOTE] 请在提交 PR 前确保代码风格与现有代码一致,并通过编译。

许可证

本项目采用 GNU General Public License v3.0 许可。

关键条款:

  • ✅ 可免费使用、修改和分发
  • ⚠️ 修改后的版本必须以相同许可证开源
  • ⚠️ 使用或集成此代码的项目必须以相同许可证开源
  • ⚠️ 必须保留原始版权声明和许可证

由 Sodium_Sulfate ❤️ 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源