【KOOK】阿狸机器人 | 使用文档
时光匆匆,自从2022年6月20日,阿狸的GIT仓库创建第一个commit开始,已经过去了一年零64天,这么长的时间里,我接受到了不少朋友的支持,也有不少朋友对代码编写的帮助,在此衷心地对大家表示感谢!
但,由于拳头公司给auth鉴权接口新增了Cloudflare防火墙和人机验证,导致类似阿狸这种集中式的机器人会被直接封禁云服务器IP而无法继续使用,所以,阿狸只能和大家说拜拜了!
自 2023-08-24
起,KOOK阿狸机器人和QQ频道阿狸机器人均停止服务。
感谢!
欢迎来到 Kook-Valorant-Bot 机器人使用文档
- 开源代码:Github | Gitee
- 机器人状态页:api/v2/bot
- 爱发电支持页:点我发电
有任何问题,欢迎在本页下方评论(推荐)或加入阿狸帮助频道
0.免责声明
1.查询接口
老生常谈了,目前valorant查询的接口是使用拳头官方的登录接口获取到账户token后,用账户token请求对应的商店、任务、战绩等接口。
该接口官方没有正式公布,目前的查询操作是在官方默许
下进行的。根据外网开发者的经验(他们使用的更久)目前暂时还没有听说过有人因为该接口查询信息而被ban号。
但,没有不代表封号风险不存在!
所以,使用了登陆查询功能之后,即代表您愿意承担此类风险。
2.账户安全
机器人的代码完全开源,输出的日志中不会包含用户的账户/密码/邮箱验证码,所有信息均通过kook的私聊和kook的api传输到机器人进行处理。
- 传输过程中的私密性将由https协议来保证;
- 您的账户密码只有kook的后台能看到;
如果您担心您的账户安全,请一定要开启邮箱双重验证;或不要使用机器人。
3.自动重登
机器人什么时候会进行重登?
在查询的时候,机器人会先判断账户token是否有效,无效则cookie重登。具体场景如下:
- 执行需要登录的查询命令
- 早八的notify皮肤提醒功能会触发重登
- 早八的vip商店提醒功能会触发重登
1.帮助命令
1.hello
执行本命令,阿狸会回复你好。可用于测试阿狸是否在线
1 | /hello |
2.@阿狸
在频道内@机器人,会触发一个语句
1 | @打瓦的阿狸 |
1 | 呀,听说有人想我了,是吗? |
如果是开发者@,则会返回只有开发者才能执行的命令帮助面板
3.ahri
阿狸基础帮助命令
1 | /ahri 或 /Ahri |
4.vhelp
valorant相关命令帮助
1 | /vhelp |
2.基础命令
01.val 错误码
以下两个命令完全相同,van是val的别名
1 | /val 错误码编号 |
用这个命令可以查询游戏常见错误码的解决办法
1 | /val 1067 |
同时支持查询van开头的错误码
1 | /val 9001 |
02.DX 弹窗错误
如果你发现有人在咨询DirectX Runtime
相关的错误,可以执行此命令
1 | /dx |
03.saveid/myid
此命令用于保存(修改)用户的游戏id
1 | /saveid 游戏id |
保存后,在和别人开黑的时候,可以用myid命令快捷发出自己的游戏id
1 | /myid |
04.bundle
查询一个皮肤系列包含什么皮肤(捆绑包)
1 | /bundle 皮肤名 |
举个例子
1 | /bundle RGX # 查询显卡套 |
05.login
登录命令
1 | /login 账户 密码 |
登录您的拳头账户,如果开启了邮箱验证,机器人将提示您使用/tfa
命令进行验证
1 | /login 账户 密码 save |
后追save
,即代表您愿意将账户密码存储到机器人后台的临时变量(内存)中。存在内存中的数据会在机器人进程退出后清空,他人无法获取。
- 保存账户密码后,机器人将在尝试cookie重新登录失败后,使用账户密码进行重新登录
- 不管是vip用户还是普通用户,该功能都生效
- 不支持邮箱登录用户
save
密码。开了邮箱登录的用户,指定save后依旧不会缓存
该功能主要服务于机器人长时间开机的时候(不过目前经常需要维护重启,存的数据会丢失)
06.tfa
用于进行邮箱验证
1 | /tfa 邮箱验证码 |
如下,刚开始发送验证码,机器人会提示验证码xxx收到
如果登录成功,机器人会反馈您的游戏id
如果输入了一个错误的验证码,机器人会提示您重新输入
07.login-l
目前机器人支持至多3个拳头账户的同时登录,使用该命令可以查看当前已登录账户的游戏名和登录时间
1 | /login-l |
08.login-ap
前面提到,login登录可以指定save保存账户密码。
机器人后台会在使用账户密码重登的时候对时间进行记录,用如下命令即可查询
1 | /login-ap |
这样你就能知道机器人啥时候用过你的账户密码操作了
09.logout
如果你不希望机器人在后台操作你的账户
那就可以用这个命令登出所有账户
1 | /logout |
10.shop
查询每日商店
1 | /shop |
如果你登录了多个账户,则需指定编号(编号为/login-ap
中显示的账户序号)默认查询的是编号为0的账户商店
1 | /shop 1 |
11.night
查询夜市
1 | /night |
多账户操作和shop相同
1 | /night 账户序号 |
12.uinfo
查询用户信息(等级、经验值、玩家卡片、玩家称号、vp、rp等)
1 | /uinfo |
该命令会自动查询所有已登陆账户,无须指定编号
13.match
查询最近5场的战绩
1 | /match |
多账户查询和shop相同
绿色边框代表本场胜利,红色代表负
14.mission
查询你的每日/每周任务
1 | /mission |
目前任务uuid尚未完全收录,很多任务都处于未知状态。
需要大家在执行本命令后,帮助填写表单,尽早集齐所有任务信息。感谢!
3.皮肤提醒
1.notify-a
查询皮肤,机器人会返回一个皮肤选择表,用sts
命令选择指定的皮肤,加入皮肤提醒队列
1 | /notify-a 皮肤名 |
比如我想在商店刷出显卡暴徒的时候,让机器人私聊提醒我,那就可以用如下命令
1 | /sts 0 |
这里的0是上图中显卡暴徒的编号
2.notify-l
1 | /notify-l |
查看已添加的皮肤提醒
3.notify-d
删除notify-l
中不需要提醒的皮肤
1 | /notify-d 皮肤uuid |
示例
1 | /notify-d 6f2aefab-439d-140a-4dc6-87818e2d72cd |
4.皮肤评价
所谓皮肤评价,就是查询商店的时候,显示在结果之下的信息。采用leancloud存储皮肤评价,数据库已在kook和qq频道的阿狸机器人中共用。
目前尚有大量皮肤未评价,计算而出的商店评分参考价值低。还需各位多多帮助!
1.rate
该命令和notify-a类似,需要先通过皮肤名查找需要评论的皮肤
1 | /rate 皮肤名 |
示例
1 | /rate 离子 |
2.rts
执行过rate命令后,用rts命令进行选择
1 | /rts 序号 打分 吐槽 |
3.kkn
执行本命令,查看昨日评分最高/最低用户
1 | /kkn |
由于目前皮肤评价数据不足,所以参考性低
5.VIP专属
阿狸的VIP基础权益如下
- 「全新商店展示图」vip用户将获取到16-9的超帅商店返回值
- 「商店图片背景自定义」vip用户可自定义商店查询结果的图片背景
- 「保存登录信息」vip用户登陆后,阿狸会自动保存您的cookie。在阿狸维护重启的时候,您的登录信息不会丢失(注:cookie内并不包含你的账户密码)
- 「早八商店提醒」阿狸将在早8点获取vip用户的每日商店并私聊发图给用户。同时会对这张图片进行缓存,当天使用
/shop
命令的时候,只需2s获取结果,三倍于普通用户的响应速度!
一些说明
- 目前商店查询diy背景图支持16-9(横屏)的图片
- 请不要设置违规图片(擦边也不行)!若因为您上传违禁图片后导致阿狸被封,您将被剥夺vip权益并永久禁止兑换vip
1.vip-u
该命令用于兑换vip的激活码
1 | /vip-u 激活码 |
当您在爱发电购买vip后,爱发电会给您私聊一个vip的激活码。私聊阿狸,使用该激活码即可激活vip。同一激活码只可使用一次。
2.vip-c
查看vip的剩余时间
1 | /vip-c |
3.vip-shop
目前支持保存4张背景图
3.1 查看已保存背景图
查看已保存的商店自定义背景图
1 | /vip-shop |
3.2 切换背景图
这里出现了图片的编号,如果需要切换图片,使用如下命令
1 | /vip-shop-s 图片编号 |
就可以切换到对应的背景图
3.3 删除背景图
由于仅支持4个背景图,所以添加更多背景图之前,需要先删除已有的
1 | /vip-shop-d 图片编号 |
示例如下
3.4 添加背景图
图片url获取看
3.5
请尽量使用kook上传图片后设置背景图,或使用国内能直连的图床图片url,否则背景图设置很可能出错。
1 | /vip-shop 图片url |
示例
1 | /vip-shop https://img.kookapp.cn/assets/2023-04/QUGTtwWxuv6bk2l4.jpg |
3.5 如何获取图片url
1 | PC端将图片上传到kook → 点击图片 → 底部...处复制图片链接 → 使用/vip-shop命令设置背景 |
6.娱乐命令
01.roll 骰子
该命令可以掷骰子(生成随机数)
1 | /roll 左边界 右边界 生成数量 |
示例
1 | /roll 1 100 3 |
如果不给第三个数量参数,则默认只生成一个随机数
1 | /roll 1 100 |
02.countdown 倒计时
在本频道触发一个倒计时
1 | /countdown 秒数 |
示例
1 | /countdown 120 |
生成一个120秒的倒计时
03.tl 翻译
该命令为translate的缩写,用于翻译。支持中英互译,以及部分外国语言翻译成中文
1 | /tl 内容 |
机翻,图一乐
1 | /tlon |
这两个命令是在本频道开启/关闭实时翻译
开启后,用户发送的所有信息都会被翻译出来
用/tloff
关闭实时翻译
04.we 天气
该命令可以用于查询城市的天气情况
1 | /we 城市 |
The end
阿狸的命令就这些啦,有任何问题都可以在下方留言!