简介
立项
Menhera酱(中文:七濑胡桃)是由Super水神(ID:Super_Water_God
,以下简称作者)在学习Python的时候边摸索边学的产物,起初只是为了解决薇尔莉特(也是Bot)无法绑定含有下划线ID的问题。随着功能的不断完善,以及在各位玩家、管理及服主的宣传下,目前Menhera酱已经服务于100+个服务器/群。
名称由来
其实,Bot最早叫LittleFireDevil,不过感觉不够二次元,没有精神,于是想到曾经火过的Menhera酱。
根据官方设定:
形象设定为一位16岁的高中生少女,拥有及肩短发,身着黑色长袖连帽衣。容易过量饮酒和进食。容易生病。有点小神经。爱好是沐浴和音乐,讨厌孤独感。
与目前的Bot非常吻合╰( ̄ω ̄o)
数据来源
战绩查询主要使用BOB提供的公开API
服务器管理使用K-ON提供的API
其他功能(天眼查、详细服务器以及在线P图等)使用EA原生接口及自己搭建API
使用说明
注意事项
- 本Bot为用爱发电项目,所有赞助均为个人自愿,不存在任何强制收费。赞助地址:https://afdian.net/@SuperWaterGod
- 本Bot一切解释权归作者所有,当用户违反相关规定,作者有权回收其使用权
- 未经沟通,擅自移除Bot,将永久不再接收申请
- 本Bot已启用自动保护功能,当发生下列情况时,Bot将自动退群:
- 当Bot被禁言时
- 当作者被移出群时
- 当服主/群主违反相关规定时
注:当因前两条原因触发自动保护机制时,从负责人联系作者时开始计算,恢复使用的时间为:第一次为2天后、第二次为一周后……
前提须知
名词解释
下列名词仅适用于战地1
ApiKey
:由唯桶签发的绑定服务器的密钥,可用于服务器管理软件、Menhera酱和梓喵等远程服务器管理工具
remid
:账号cookie的一部分
sid
:账号cookie的一部分
SessionId
:最终操作时所需的密钥,可由remid和sid生成
GameId
:服务器的标识码,当服务器续费后会发生变化
ServerId
:服务器的唯一标识码,不会发生变化
PersonId
:玩家唯一标识码,不会随改ID而变化
功能模块总览
通过使用/config
来查看模块的启用情况
通过使用/set <模块名称> <true/false>
来启用/关闭模块
注:模块名称区分大小写,需admin权限
例如:/set AutoReply false
AutoReply
:根据关键词自动回复表情包/语音,建议500人数以上关闭该功能例如:dalao、OK、战神、有了等
battlefield
:战地1战绩等数据的查询例如:/武器、/载具、/服务器、/天眼查等
bilibili
:B站视频推送注:需先关注UP主的UID
Chat
:图灵机器人聊天注:需@Bot才会触发
GroupEvent
:加群/退群消息提醒schedule
:定时发送每日统计slogan
:在线生成表情包Nudge
:戳一戳消息提醒bfban:联ban举报(未实装)
命令
本Bot除在线生成表情包功能外所有命令均由”/“开头
在线生成表情包的@必须手动输入才能生效
[]表示可填选项,<>表示必填选项
[]和<>均不必输入
权限系统
本Bot内置一个简单的权限系统,从上至下分为:
developer
:全局最高权限,默认开发者,可以添加admin
和ban
以及配置所有群的设置
admin
:群内最高权限,默认群主,可以添加manager
和ban
以及配置本群的设置
manager
:服务器管理,默认为空,可以使用服务器管理相关命令和其他高级命令
normal
:普通群友,默认所有群员
black
:黑名单,因涉嫌调戏Menhera酱而被拉黑,除管理服务器所有功能不可使用
ban
:封禁名单,所有命令均无响应
所有功能详解
战地1战绩等数据查询
绑定服务器关键词
绑定查询时服务器的关键词
命令:/BindServer <服务器关键词>
权限:需admin
及以上权限
例如:/BindServer bob
注意:
- 关键词建议绑定服务器标题中的群号
服务器
查询服务器当前地图以及人数,以图片形式返回
命令:/服务器 [服务器关键词]
例如:/服务器 bob
注意:
- 如果[]内容不填写,将查询已绑定的名称
- 最多显示8个服务器,并将按照人数排序
查服务器
查询服务器当前地图、人数以及GameId
,以文字形式返回
命令:/查服务器 [服务器关键词]
例如:/查服务器 bob
注意:
- 如果[]内容不填写,将查询已绑定的名称
- 该命令主要用来查询
GameId
查询服务器详细信息
查询服务器当前地图池、战队、服务器设置等,以图片形式返回
命令:/详细服务器 <GameID>
例如:/详细服务器6055634420250
注意:
GameId
可以通过”/查服务器”获得
搜索行动服
搜索所有被收录的行动服务器,按照人数排序,以图片形式返回
命令:/行动服 [收藏]
例如:/行动服
注意:
- 如果填写[]内的文字,将按照收藏数量排序
绑定游戏ID
将QQ号与游戏ID绑定,方便不再输入自己的ID
命令:/绑定 [游戏ID]
例如:/绑定 Super_Water_God
注意:
如果[]内容不填写,将自动绑定群昵称
绑定一次即可,无需重复绑定
无需输入战队前缀
游戏ID仅有A-Z、a-z以及_和-组成
游戏ID不区分大小写
战绩
查询玩家生涯所有战绩,以文字形式返回
命令:/战绩 [游戏ID]
例如:/战绩 Super_Water_God
注意:
- 如果[]内容不填写,将自动使用绑定过的ID
查战绩
查询玩家生涯所有战绩,以图片形式
命令:/查战绩 [游戏ID]
例如:/查战绩 Super_Water_God
注意:
- 如果[]内容不填写,将自动使用绑定过的ID
武器
查询玩家击杀前5的武器数据,按照总击杀排序,以图片形式返回
命令:/武器 [游戏ID]
例如:/武器 Super_Water_God
注意:
- 如果[]内容不填写,将自动使用绑定过的ID
- 当击杀超过4000时,会有白色光耀
- 当击杀超过6000时,会有蓝色光耀
- 当击杀超过10000时,会有金色光耀
- 命中率无法显示超过100%
- 通过赞助可以解锁其他背景
武器分类
查询玩家击杀前5的某种武器分类的数据,按照总击杀排序,以图片形式返回
命令:/冲锋枪|轻机枪|步枪|半自动|霰弹枪|手枪|手榴弹|精英兵|近战|装备|驾驶员 [游戏ID]
例如:/冲锋枪 Super_Water_God
注意:
- 与”武器”相同
- 部分武器数据因EASB缺失,例如:波顿、Annihilator(冲锋)等
载具
查询玩家击杀前5的载具数据,按照总击杀排序,以图片形式返回
命令:/载具 [游戏ID]
例如:/载具 Super_Water_God
注意:
- 与”武器”相同
- 不同国家的飞机分开计算
最近战绩
查询玩家最近的游戏数据,数据源自Battle Tracker,以文字形式返回
命令:/最近 [游戏ID]
例如:/最近 Super_Water_God
注意:
- 如果[]内容不填写,将自动使用绑定过的ID
- 部分游戏ID可能查询不到
玩家成分查询
一键查询玩家的PersonId
、登录时间、战队、联BAN信息、小助手、最近游玩服务器、正在游玩以及亚洲服务器记录情况,以文字形式返回
命令:/天眼查 [游戏ID]
例如:/天眼查 Super_Water_God
权限:”正在游玩”需要manager及以上权限
注意:
- 如果[]内容不填写,将自动使用绑定过的ID
- 部分消息仅显示部分文本
本周皮肤交换
查询本周皮肤交换及其费用,以图片形式返回
命令:/交换
例如:/交换
注意:
- 部分武器品质与游戏内不一致,一切以游戏内为准
武器百科
查询武器理论数据,以图片形式返回
命令:/武器 <突击|医疗|支援|侦察|配枪|杂项>
例如:/武器 突击
注意:
- 关键词必填
- 数据最后更新于2018.11,切不再更新
亚洲私服在线情况
查询当前亚洲私服游玩人数情况
命令:/bf1status
例如:/bf1status
注意:
- 服务器剩余人数必须达到总人数的一定比例才会被计算到
战地1服务器管理相关
服务器管理功能默认关闭。如想启用,请先联系作者
需要准备:有服务器管理权限的remid
和sid
,以及对应的Apikey
绑定服务器
绑定所需操作服务器的别名
命令:/setserver#<编号> <GameId>
权限:需admin
及以上权限
例如:/setserver#1 6055634420250
注意:
GameId
可以通过”/查服务器”获得- 编号仅支持一位字符,通常为1-9
刷新SessionId
刷新绑定账号的SessionId
命令:/refresh
权限:需manager
及以上权限
例如:/refresh
注意:
- 通常情况
SessionId
将每2h自动刷新一次 - 如提示
SessionId
过期,请手动刷新
批量检测生涯战绩
批量检测生涯战绩的KD、KPM和LV,当超出设定时自动踢出
命令:/check#<编号> <ID...>
权限:需manager
及以上权限
例如:/check#1 Super_Water_God Little_Fire_Devil
注意:
- 一次最多输入8个
- KD、LV和KPM需联系作者设置
服务器历史记录
查询服务器最近1周的在线人数以及收藏变化曲线
命令:/历史人数#<编号>
例如:/历史人数#1
注意:
- 每次记录时间间隔为20min
查询服务器详细信息
查询服务器当前地图池、战队、服务器设置等,以图片形式返回
命令:/详细服务器#<编号>
权限:需manager
及以上权限
例如:/详细服务器#1
注意:
- 必须绑定
GameId
踢出玩家
将某玩家从指定服务器中踢出
命令:/k#<编号> <ID> [理由]
或者 /kick#<编号> <ID> [理由]
权限:需manager
及以上权限
例如:/k#1 Super_Water_God test
注意:
- 即使该玩家不在服务器内,依旧能成功踢出
- 无法踢出服务器管理,除非绑定了服主账号
- 理由最多支持6个中文或者24个英文
封禁玩家
将某玩家从指定服务器中封禁
命令:/b#<编号> <ID>
或者 /ban#<编号> <ID>
权限:需manager
及以上权限
例如:/b#1 Super_Water_God
注意:
- 无法封禁服务器管理,除非绑定了服主账号
- 无需输入理由
解封玩家
将某玩家从指定服务器中解封
命令:/ub#<编号> <ID>
或者 /unban#<编号> <ID>
权限:需manager
及以上权限
例如:/ub#1 Super_Water_God
注意:
- 即使未被封禁,依旧能成功解封
添加VIP
将某玩家添加至指定服务器的VIP列表
命令:/+v#<编号> <ID>
或者 /+vip#<编号> <ID>
权限:需manager
及以上权限
例如:/+v#1 Super_Water_God
注意:
- 暂时无法指定VIP到期时间
移除VIP
将某玩家从指定服务器的VIP列表移除
命令:/-v#<编号> <ID>
或者 /-vip#<编号> <ID>
权限:需manager
及以上权限
例如:/-v#1 Super_Water_God
注意:
- 即使不在VIP列表中,依旧能成功移除VIP
切换地图
更换服务器当前地图
命令:/sm#<编号> <MapID>
或者 /switchmap#<编号> <MapID>
权限:需manager
及以上权限
例如:/sm#1 1
注意:
- 切换地图时,服务器内必须有人
- MapID可以通过
/详细服务器
获得,第一张地图的MapID
为0,以此类推
更换队伍
将某玩家从指定服务器中更换队伍
命令:/ss#<编号> <ID> <1/2>
或者 /switchside#<编号> <ID> <1/2>
权限:需manager
及以上权限
例如:/ss#1 Super_Water_God 1
注意:
- 即使不在服务器中,依旧能成功更换队伍
- 队伍1和队伍2根据不同地图代表不同阵营
踢出轮椅人
将某残疾人从指定服务器中踢出,并自动填写理由:服务器禁止使用SMG08/18
命令:/smg#<编号> <ID>
或者 /s#<编号> <ID>
权限:需manager
及以上权限
例如:/s#1 Super_Water_God
注意:
- 即使该玩家不在服务器内,依旧能成功踢出
- 无法踢出服务器管理,除非绑定了服主账号
- 理由已自动填写,无需输入
持续折磨
将某玩家从指定服务器中持续更换队伍并踢出
命令:/zm#<编号> <ID>
权限:需manager
及以上权限
例如:/zm#1 Super_Water_God
注意:
- 每次更换队伍的时间间隔为3s
- 在更换18次队伍后,将尝试踢出该玩家
配置群文件
列出所有模块
列出本群已启用/未启用的模块
命令:/config
例如:/config
注意:
- [×]表示功能关闭,[√]表示功能开启
启用/关闭模块
启用/关闭指定模块
命令:/set <功能名称> <true/false>
权限:需admin
及以上权限
例如:/set AutoReply true
注意:
- 注意大小写
- 功能请按需开启
列出admin
列表
列出本群所有有admin
权限的QQ
命令:/adminlist
例如:/adminlist
注意:
- 默认为Bot和群主
列出manager
列表
列出本群所有有manager
权限的QQ
命令:/managerlist
例如:/managerlist
注意:
- 默认为空,需
admin
手动添加
添加manager
权限
为某QQ添加manager
权限
命令:/addmanager <qq号>
权限:需admin
及以上权限
例如:/addmanager 123456
注意:
- 一次仅能添加一个QQ
移除manager
权限
将某QQ移除manager
权限
命令:/removemanager <qq号>
权限:需admin
及以上权限
例如:/removemanager 123456
注意:
- 一次仅能移除一个QQ
查看关注UP主
查看本群关注的B站UP主
命令:/bilibili
例如:/bilibili
注意:
- 如需接收通知,请先把
bilibili
模块开启 - 关注列表为
UID
关注UP主
关注B站某UP主
命令:/follow <UID>
权限:需admin
及以上权限
例如:/follow 2723333
注意:
UID
可以在B站个人资料中找到- 第一次关注将会推送最近3部视频
- 关注后,将每隔5min检测一次是否有新视频
取关UP主
取关B站某UP主
命令:/unfollow <UID>
权限:需admin
及以上权限
例如:/unfollow 2723333
注意:
- 取关后立即生效
查看Bot状态
查看Bot当前运行情况
命令:/status
例如:/status
注意:
- 一切以实际为准
查看Bot统计资料
查看Bot当前运行的统计资料
命令:/每日统计
例如:/每日统计
注意:
- 每日统计将在每天的00:00更新
黑名单相关
Menhera酱是一个内心很敏感的女孩
所以请不要骂她╰(‵□′)╯
否则她就会记下仇恨,不再理你
除非你和她道歉(ˉ▽ˉ;)…
触发机制
当@bot,并回复含有攻击、辱骂等词汇时,将自动添加至黑名单
触发后果
除服务器管理功能外,所有功能均不可使用
如何解封?
- 当@bot,并回复”我错了”,”对不起”等道歉用语
- 等待Bot回复并提问
- 根据Bot提问,@Bot并回复正确的关键词
(我是傻逼) - 等待原谅
在线表情包生成
该部分需打开slogan
模块
摸一摸
命令:摸@指定目标
样例:
亲一亲
命令:亲@指定目标
样例:
流汗黄豆
命令:流汗@指定目标
样例:
诺基亚表情包
命令:诺基亚 消息 .jpg
样例:
狂热表情包
命令:消息 狂热.jpg
样例:
其他功能
查询浓度
查看Bot当前运行情况
命令:/查询浓度@指定目标
权限:需manager
及以上权限
注意:
- 一切以实际为准
- 判断依据为该QQ的头像
更新计划
- 服务器管理功能配置
- 服务器历史人数检测
- 亲一亲
- 整合天眼查
- 战绩数据补全
- 亚洲私服数据追踪
- 服务器详细
- 群浓度
- 百科小助手
- 建立备份API服务器,预防第三方服务出错
- 获取当前服务器内玩家
- 快速举报至bfban
…… ……
赞助名单
感谢各位的无私赞助!Menhera酱能发展到现在离不开大家的帮助!