- 版权类型
- 原创
- 语言支持
- 中文（简体）
- 前置组件
- SparkBridge3新一代QQ群服互通机器人
https://www.minebbs.com/resources/sparkbridge-bot-qq.15586/
- 适配版本（基岩）
- 最新版本
IK系列插件QQ交流群：
318569582
插件简介
GroupAnnounceListener 是一款专为 SparkBridge 框架设计的桥接插件，它通过智能化识别QQ群消息，自动将重要公告转发至Minecraft服务器中。无论是服务器更新、活动通知还是日常提醒，管理员只需在QQ群内像平时一样发布公告，插件便能自动捕获并同步到游戏内，实现社区与游戏的无缝沟通。
核心功能
- 智能识别：自动识别管理员发布的包含“公告”关键词或
@全体成员的群消息，并将其判定为待同步公告。 - 原样转发：完整保留公告内容的原始排版、分段和换行，并以彩色美化格式在服务器公屏中广播，确保信息清晰美观。
- 灵活配置：提供丰富的配置项，可自由开关公屏转发功能、设置监听群号、管理关键词列表，并能控制机器人的回复提示。
- 便捷管理：集成完整的指令系统，支持在QQ群内通过指令
!设置群、!开启MC转发等快速管理插件，并可通过!测试公告随时诊断识别状态。
安装与配置教程
1. 安装插件- 下载
GroupAnnounceListener插件压缩包。 - 将其解压至 SparkBridge 目录下的
plugins文件夹内。 - 重启 SparkBridge 服务。
插件启动后，在需要监听的QQ群内（需要管理员权限），依次执行以下指令进行初始化配置：
!设置群 [群号]：绑定要监听的QQ群。- （可选）
!添加词 [关键词]：添加除“公告”外其他需要识别的关键词。 !开启MC转发：启用向Minecraft服务器的广播功能。!开启回复：开启机器人接收消息后的确认回复。
@全体成员的消息时，机器人会回复“
公告已记录！”，同时服务器公屏将收到格式化的公告信息。
指令与权限说明所有指令均需在 已绑定的QQ群内 使用。
配置管理指令 (需管理员权限)
- !设置群 [群号]
功能：绑定需要监听公告的QQ群。
示例：!设置群 123456789 - !开启MC转发 / !关闭MC转发
功能：开启或关闭向Minecraft服务器公屏广播公告的功能。 - !开启回复 / !关闭回复
功能：开启或关闭机器人收到公告后的确认回复（“ 公告已记录！”）。 - !添加词 [关键词] / !删除词 [关键词]
功能：增加或移除公告识别的关键词（默认已有“公告”一词）。
示例：!添加词 通知， !删除词 通知
查询与诊断指令 (所有成员可用)
- !查看配置
功能：查看插件当前的详细配置（如监听群号、MC转发开关状态等）。 - !测试公告
功能：对当前您发送的这条消息进行实时诊断，返回是否会被识别为公告及具体原因。 - !查看公告
功能：在QQ群内查看已保存的最新一条公告的完整内容。 - !帮助
功能：显示完整的指令帮助信息（也可通过@机器人触发）。
常见问题 (FAQ)
- Q：插件支持哪些Minecraft服务端？
A：本插件运行于 SparkBridge 框架，只要您的服务器正确部署了SparkBridge即可使用，与服务端核心（如Spigot、Paper）无关。 - Q：如何让公告只转发，但不在QQ群内回复“已记录”？
A：使用!关闭回复指令即可。 - Q：非管理员发的
@全体成员消息会被转发吗？
A：默认配置下不会。插件默认仅监听管理员和群主的消息，普通成员的消息会被忽略，以避免干扰。
获取帮助
如果在使用中遇到问题，欢迎在MineBBS的本插件发布帖下留言。作为原创作者，我会定期查看并回复。同时，您也可以在QQ群内使用 !测试公告 指令来实时诊断识别逻辑，快速排查问题。免责声明：本插件为开源原创项目，仅供学习交流使用。请确保在使用过程中遵守SparkBridge及相关平台的使用条款。
