- 版权类型
- 原创
- 插件中文名称
- 群服互联
- 插件英文名称
- XZQQBot
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Leaves
- 其他核心
- 语言支持
- 中文(简体)
- 前置组件
- (可选)PlaceholderAPI https://www.minebbs.com/resources/placeholderapi.8229/
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
XZQQBot
简介
• OneBot 连接:通过 WebSocket 连接机器人• 自动加群审核:申请理由包含关键词时自动通过进群验证
• 群聊黑名单:自动拒绝加群,入群后定时扫描成员并踢出
• 违规词检测:自动撤回消息,累计次数自动触发禁言警告
• 群聊刷屏检测:相同文字/表情包连续发送超限后撤回并禁言
• 违规名字检测:昵称/群名片含关键词时踢出并拉黑(支持白名单)
• 进服绑定:未绑定玩家进服获得验证码,群内发送完成绑定,退群自动解绑
• 在线查询:群内触发后生成状态图片返回,支持服务器地址 或 Papi占位符
• 远程执行:管理员在群内或私聊发送 `/执行`,以控制台身份执行游戏命令
命令
插件命令
命令 | 说明 |
|---|---|
/xzqqbot reload | 重载配置文件 |
机器人命令
| 命令 | 说明 |
|---|---|
| /拉黑 (游戏名/QQ号) | 将该玩家或该QQ添加到黑名单 |
| /解黑(游戏名/QQ号) | 将该玩家或该QQ从黑名单移除 |
| /查询(游戏名/QQ号) | 查询该玩家或该QQ号的绑定关系 |
| /绑定 (QQ号)(游戏名) | 手动为该玩家或QQ号进行绑定 |
| /解绑(游戏名/QQ号) | 手动为该玩家或QQ号进行解绑 |
| /执行(命令) | 以控制台身份执行游戏命令 |
配置
config.yml(主要配置文件)
YAML:
# OneBot WebSocket服务端配置
onebot:
# WebSocket服务器地址
host: "ws://127.0.0.1:3001"
# 访问令牌(如果没有设置access_token可留空)
access-token: ""
# 管理员QQ列表
admins:
- 3414446
# QQ群号列表(支持多个群)
group-ids:
- 1234567890
# 自动同意加群申请配置
auto-approve:
# 是否启用自动同意加群申请
enabled: true
# 申请消息包含任一关键词即自动通过
keywords:
- "哔哩哔哩"
- "哔哩"
- "B站"
- "b站"
- "小破站"
- "快手"
- "抖音"
# 违规词列表
banned-words:
- "操"
- "妈"
- "逼"
- "nmsl"
- "sb"
# 检测到违规词时的回复消息
violation-message: "您发送的消息包含违规词,已被撤回"
# 是否启用违规词检测
banned-words-enabled: false
# 刷屏检测配置
spam:
# 是否启用刷屏检测
enabled: false
# 相同消息/表情包连续发送超过此次数触发禁言
limit: 5
# 触发刷屏禁言时的群内通知消息(%qq% 为被禁言的QQ号)
message: "用户 %qq% 因刷屏已被禁言1小时!"
# 诈骗名字检测配置
scam-name-detection:
# 是否启用诈骗名字检测
enabled: true
# QQ昵称或群名片包含以下任一关键词,立即踢出并拉黑
keywords:
- "服主"
- "技术"
- "赞助"
- "充值"
- "管理"
# 白名单(白名单内的QQ号不会被检测,无论名字是什么)
whitelist:
- 3414446
# 检测到诈骗名字时的群内通知消息(%qq% 为被踢出的QQ号)
message: "成功检测到一位诈骗犯 [%qq%] 已踢出并且拉黑!"
bind.yml(进服绑定配置文件)
YAML:
# 是否启用进服绑定验证
enabled: true
# 未绑定玩家被踢出时显示的断开连接界面消息(支持 & 颜色代码,\n 换行,%player% 游戏ID,%code% 验证码)
kick-message: "&f欢迎来到&e宝可梦之旅!\n\n&a&l请先加入QQ群:555982528\n&f&l在群内发送此内容:&b&l'%code%'\n&f&l即可让当前账号&f&l[&b&l%player%&f&l]&f&l进入服务器\n\n&c&l注册完成之前请勿泄露自己用户名!"
# 绑定成功时机器人在群内的回复(%player% 游戏ID,%qq% QQ号)
success-message: "%player% 验证成功!\n你现在可以进入服务器啦!"
# 该QQ已绑定其他游戏ID时的回复(%player% 已绑定的游戏ID)
qq-already-message: "你的QQ已绑定游戏账号:%player%,无法重复绑定!"
# 该游戏ID已被其他QQ绑定时的回复
player-already-message: "该游戏账号已被其他QQ绑定,无法绑定!"
blacklist.yml(黑名单配置文件)
YAML:
# 黑名单用户QQ号列表
blacklist:
- 1234567890
# 黑名单用户被拒绝时的回复消息
blacklist-message: "您已被加入黑名单,无法加入本群"
online.yml(在线查询配置文件)
YAML:
# 是否启用在线人数查询功能
enabled: true
# 触发指令(群内发这些内容返回在线状态图片)
commands:
- "/在线"
# 图片标题
title: "服务器在线"
# 全服在线人数行模板(%server_online% 替换为总在线数)
total-line: "全服在线:%server_online% 位"
# 子服列表,格式:显示名称:服务器地址(群组服可使用占位符)
sub-servers:
- "登录:%bungee_登录大厅%"
- "一区:127.0.0.1:6666"
- "二区:127.0.0.1:9999"
# 自定义背景图文件名(放在 plugins/XZQQBot/ 目录下,留空使用默认渐变黑色背景)
background-file: "bg.png"
# 图片尺寸
image-width: 600
image-height: 450
结语
感谢使用 XZQQBot 插件,我会持续更新更多功能。对于插件如果你有任何问题或建议,请添加作者的QQ:3414446