- 版权类型
- 原创
- 插件中文名称
- QQ群管家
- 插件英文名称
- QQGroupBot
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 前置组件
- 必需依赖：PlaceholderAPI
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
QQGroupBot 是一款面向 Minecraft 服务器的 QQ 群互联与账号管理插件。它不只是简单地转发聊天消息，而是围绕 OneBot 11 打通 QQ 群与游戏服务器，集成玩家绑定、入服白名单、群服消息同步、在线查询、账号保护及群内假人管理等实用能力。
插件支持 Paper 与 Folia 调度环境，并提供 SQLite、MySQL 两种存储方案。无论是单服快速部署，还是多台服务器共用同一 QQ 群，都可以通过独立服务器标识和统一配置完成接入。
JiaRen 假人联动： 已绑定且拥有指定 LuckPerms 权限组的玩家，可在 QQ 群内让自己的 JiaRen 假人上线。插件支持服务器目标识别、首次上线主人在线校验、假人归属检查、世界状态检查及完整结果反馈。
核心技术亮点
1. Paper 与 Folia 调度兼容
插件声明支持 Folia，并针对聊天同步、网络通信及群指令等任务使用相应调度器处理。涉及 Bukkit 实体和服务器状态的操作会切回适合的调度上下文，降低跨线程调用带来的兼容问题。
2. SQLite 与 MySQL 双存储
默认内置 SQLite 本地数据库，开箱即可使用；需要多服共用数据时可切换至 MySQL。底层使用 HikariCP 管理数据库连接，并为常用的玩家名和 QQ 查询字段建立索引。SQLite 模式启用 WAL 与忙等待机制，在保持轻量部署的同时提高读写稳定性。
3. 完整的 OneBot 11 消息适配
插件通过 OneBot 11 WebSocket 接收事件，并通过 HTTP API 发送消息。兼容标准消息段、CQ 图片码及新版 CICode 图片格式；图片、文件、回复、表情、语音、视频和合并转发等内容会转换为可自定义的游戏内提示，避免将冗长的资源地址直接刷入聊天栏。
4. 多层权限与归属校验
群内管理功能不只校验 QQ 管理员列表。使用 JiaRen 假人功能时，还会依次校验 QQ 是否已绑定玩家、玩家的 LuckPerms 主权限组以及假人归属，避免已授权成员操作其他玩家的假人。
5. 平滑的数据与配置升级
配置热重载时会自动补充新版缺失项，同时保留已有配置值；数据库启动时会自动创建表、补充字段、建立索引并同步绑定统计。旧 QQConnect 数据目录也可自动迁移至新的 `plugins/QQGroupBot/` 目录。
核心功能
QQ 白名单绑定： 玩家进入服务器后可获得限时验证码，在指定 QQ 群内完成游戏账号绑定；验证码默认有效期为 5 分钟。
绑定数量控制：可限制每个 QQ 最多绑定的游戏账号数量，管理员手动添加不受普通玩家自助绑定上限影响。
自动退群解绑： 可在成员退出 QQ 群后自动删除该 QQ 对应的全部白名单，避免退群成员继续使用已绑定账号进入服务器。
双向聊天同步：支持 Minecraft 到 QQ、QQ 到 Minecraft 的双向消息同步，可分别设置触发前缀、消息格式和屏蔽词，并支持多个 QQ 群之间同步文本消息。
真实玩家名识别： QQ 消息进入游戏时，已绑定成员优先显示数据库中的真实游戏名；未绑定成员才使用群名片或 QQ 昵称。
进服与启停通知：支持玩家进入服务器通知，以及服务器启动、关闭时向指定 QQ 群发送提示。
群成员自动审核：可自动处理加群请求，并支持过滤曾经退群的账号、限制最低 QQ 等级、发送新成员欢迎消息及设置默认群名片。
群名片管理：绑定成功后可自动将群名片修改为玩家名，也可通过 PlaceholderAPI 自定义名片格式并启用群名片锁定。
群内查服： 管理员可直接在 QQ 群内查询各服务器的在线人数与玩家列表。多台服务器监听同一 QQ 群时，会根据各自的 `server-name` 分别返回状态。
账号登录保护： 可记录玩家授权 IP，未授权地址登录时自动拦截；配合 AuthMe 后，玩家还可从已绑定的 QQ 群账号触发在线账号强制登录。
自定义群关键词：可配置任意关键词及多行回复，并支持调用 PlaceholderAPI 变量或执行控制台指令，适合制作帮助查询、账号注销和服务器信息查询等功能。
基岩版兼容：可选接入 Floodgate，为 Geyser/Floodgate 基岩版玩家提供相应账号处理支持。
插件支持 Paper 与 Folia 调度环境，并提供 SQLite、MySQL 两种存储方案。无论是单服快速部署，还是多台服务器共用同一 QQ 群，都可以通过独立服务器标识和统一配置完成接入。
JiaRen 假人联动： 已绑定且拥有指定 LuckPerms 权限组的玩家，可在 QQ 群内让自己的 JiaRen 假人上线。插件支持服务器目标识别、首次上线主人在线校验、假人归属检查、世界状态检查及完整结果反馈。
核心技术亮点
1. Paper 与 Folia 调度兼容
插件声明支持 Folia，并针对聊天同步、网络通信及群指令等任务使用相应调度器处理。涉及 Bukkit 实体和服务器状态的操作会切回适合的调度上下文，降低跨线程调用带来的兼容问题。
2. SQLite 与 MySQL 双存储
默认内置 SQLite 本地数据库，开箱即可使用；需要多服共用数据时可切换至 MySQL。底层使用 HikariCP 管理数据库连接，并为常用的玩家名和 QQ 查询字段建立索引。SQLite 模式启用 WAL 与忙等待机制，在保持轻量部署的同时提高读写稳定性。
3. 完整的 OneBot 11 消息适配
插件通过 OneBot 11 WebSocket 接收事件，并通过 HTTP API 发送消息。兼容标准消息段、CQ 图片码及新版 CICode 图片格式；图片、文件、回复、表情、语音、视频和合并转发等内容会转换为可自定义的游戏内提示，避免将冗长的资源地址直接刷入聊天栏。
4. 多层权限与归属校验
群内管理功能不只校验 QQ 管理员列表。使用 JiaRen 假人功能时，还会依次校验 QQ 是否已绑定玩家、玩家的 LuckPerms 主权限组以及假人归属，避免已授权成员操作其他玩家的假人。
5. 平滑的数据与配置升级
配置热重载时会自动补充新版缺失项，同时保留已有配置值；数据库启动时会自动创建表、补充字段、建立索引并同步绑定统计。旧 QQConnect 数据目录也可自动迁移至新的 `plugins/QQGroupBot/` 目录。
核心功能
QQ 白名单绑定： 玩家进入服务器后可获得限时验证码，在指定 QQ 群内完成游戏账号绑定；验证码默认有效期为 5 分钟。
绑定数量控制：可限制每个 QQ 最多绑定的游戏账号数量，管理员手动添加不受普通玩家自助绑定上限影响。
自动退群解绑： 可在成员退出 QQ 群后自动删除该 QQ 对应的全部白名单，避免退群成员继续使用已绑定账号进入服务器。
双向聊天同步：支持 Minecraft 到 QQ、QQ 到 Minecraft 的双向消息同步，可分别设置触发前缀、消息格式和屏蔽词，并支持多个 QQ 群之间同步文本消息。
真实玩家名识别： QQ 消息进入游戏时，已绑定成员优先显示数据库中的真实游戏名；未绑定成员才使用群名片或 QQ 昵称。
进服与启停通知：支持玩家进入服务器通知，以及服务器启动、关闭时向指定 QQ 群发送提示。
群成员自动审核：可自动处理加群请求，并支持过滤曾经退群的账号、限制最低 QQ 等级、发送新成员欢迎消息及设置默认群名片。
群名片管理：绑定成功后可自动将群名片修改为玩家名，也可通过 PlaceholderAPI 自定义名片格式并启用群名片锁定。
群内查服： 管理员可直接在 QQ 群内查询各服务器的在线人数与玩家列表。多台服务器监听同一 QQ 群时，会根据各自的 `server-name` 分别返回状态。
账号登录保护： 可记录玩家授权 IP，未授权地址登录时自动拦截；配合 AuthMe 后，玩家还可从已绑定的 QQ 群账号触发在线账号强制登录。
自定义群关键词：可配置任意关键词及多行回复，并支持调用 PlaceholderAPI 变量或执行控制台指令，适合制作帮助查询、账号注销和服务器信息查询等功能。
基岩版兼容：可选接入 Floodgate，为 Geyser/Floodgate 基岩版玩家提供相应账号处理支持。
