Arknights Helper
基于 Mirai Console 的 明日方舟 助手插件
使用前应该查阅的相关文档或项目
指令
注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/抽卡 十连
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数
本插件指令权限ID 格式为 xyz.cssxsh.mirai.plugin.arknights-helper:command.*, * 是指令的第一指令名
例如 /抽卡 十连 的权限ID为 xyz.cssxsh.mirai.plugin.arknights-helper:command.gacha
助手抽卡指令
| 指令 | 描述 |
|---|---|
/<gacha 抽卡> <one 单抽> [times]? |
单抽times次，默认为1 |
/<gacha 抽卡> <one 十连> [times]? |
十连times次，默认为1 |
/<gacha 抽卡> <detail 详情> |
查看卡池规则 |
/<gacha 抽卡> <set 设置> [name] |
设置卡池为name, 默认为NORMAL |
/<gacha 抽卡> <pool 卡池> [name] [set]? {rules} |
设置卡池name的规则为rules，当set为true时设置为当前卡池 |
抽卡每一抽会消耗600合成玉，合成玉可以通过答题获得，通过玩家详情查看
ArknightsGachaCommand 卡池规则rules参数格式
rules参数从第二行起，按行分割
每行格式为规则干员名|星级|other|...:概率或者注释#...
星级用连续的*表示，例如*****表示五星干员，需要单行设置，设置的概率不包括已设置干员名
other表示剩余的其他干员
概率用小数表示，全部行的概率加起来的概率要为100%，即1.00
例子
/抽卡 卡池 限时寻访深悼
浊心斯卡蒂|凯尔希:0.014
赤冬:0.04
******:0.006
*****:0.04
****:0.48
other:0.42
助手答题指令
| 指令 | 描述 |
|---|---|
/<mine 挖矿 答题> [type]? |
机器人会提出一个问题 |
/<question 问题> <detail 详情> [name] |
查看自定义问题的详情 |
/<question 问题> <list 列表> |
列出已经设置的自定义问题 |
/<question 问题> <delete 删除> |
删除指定问题 |
/<question 问题> <add 添加> |
与机器人互动，输入条件，设置新问题 |
/<question 问题> <count 统计> |
答题情况统计 |
回复选项序号A~Z，即算回答问题
type是提问问题类型，默认为全部类型
回答了当前问题才会出现下一个问题
快速回答(规定时间的1/3内)会有相应奖励
群聊模式的其他群员亦可回答题目，但题目只能被回答一次，且其他人作为抢答者有相应奖励和惩罚
题目结构如下
[类型](得分) 问题
A. 选项
B. 选项
...
助手公招指令
| 指令 | 描述 |
|---|---|
/<recruit 公招> {words} |
查看关键词words的公招干员 |
words的数量为1~5
助手材料指令
| 指令 | 描述 |
|---|---|
/<item 材料> [name] [limit]? [now]? |
查看材料的关卡掉落率 |
/<stage 关卡> [name] [limit]? [now]? |
查看关卡的材料掉落率 |
/<zone 章节 活动 地图> [name] [limit]? [now]? |
查看地图所有关卡的材料掉落率 |
limit 是显示前多少项查询结果
now 是是否只显示当前开启关卡，默认为 true
可以通过配置材料别名设置可选的材料索引
助手玩家指令
| 指令 | 描述 |
|---|---|
/<player 玩家> <detail 详情> |
当前玩家(QQ号)在助手中的数据 |
/<player 玩家> <reason 理智> [init] |
设置玩家(QQ号)当前理智为init |
/<player 玩家> <level 等级> [index] |
设置玩家(QQ号)当前等级为index |
/<player 玩家> <recruit 公招> [site] [hours] [minutes] |
设置公招位site等待时间 |
/<player 玩家> <record 记录> |
列出玩家的公招记录 |
玩家的默认等级为120
理智的提醒时间会根据玩家等级和当前理智值init设置
助手蹲饼指令
| 指令 | 描述 |
|---|---|
/<guard 蹲饼> <detail 详情> |
当前蹲饼的状态和轮询时间 |
/<guard 蹲饼> <speed 速度> |
设置蹲饼轮询时间是speed分钟 |
/<guard 蹲饼> <open 打开> [contact]? |
开启蹲饼状态 |
/<guard 蹲饼> <close 关闭> [contact]? |
关闭蹲饼状态 |
contact 为群号或Q号，可选参数，可以自动从当前聊天环境中获取，比如私聊就获取好友Q号，群聊就获取群号
玩家的默认等级为120
理智的提醒时间会根据玩家等级和当前理智值init设置
助手数据指令
| 指令 | 描述 |
|---|---|
/<data 数据> <arknights 方舟> |
更新游戏数据 |
/<data 数据> <penguin 企鹅 掉落> |
更新掉落数据 |
/<data 数据> <name alias 别称 别名> |
查看掉落别名 |
/<data 数据> <reload 重载> |
重载插件配置 |
/<data 数据> <recruit alias 公招> |
提交公招结果 |
/<data 数据> <tag 标签分析> |
分析公招结果 |
/<data 数据> <role 干员分析> |
分析公招结果 |
/<data 数据> <clear 清理> |
清理数据 |
提交公招结果之前，可以设置干员别名方便输入
助手表情指令
| 指令 | 描述 |
|---|---|
/<arkface 方舟表情> <random 随机> [id]? |
随机发送一个表情, id是表情包id, 默认为任意表情包 |
/<arkface 方舟表情> <list 列表> |
表情商店链接列表 |
/<arkface 方舟表情> <detail 详情> |
查看表情详情 |
表情详情指令使用时, 先发送指令，然后发送一个表情，机器人会回复表情的商店链接和原图
配置文件
位于Mirai-Console运行目录下的config/xyz.cssxsh.mirai.plugin.arknights-helper文件夹下的config文件
roles
干员别名
roles:
小羊: 艾雅法拉
鳄鱼: 艾丝黛尔
items
材料别名
items:
绿管: 晶体元件
auto_add_guard
自动开启蹲饼功能 在机器人添加新好友和新群时自动开启蹲饼功能
video
开启订阅的b站视频类型 ANIME, MUSIC, GAME, ENTERTAINMENT
blog
开启订阅的微博号 BYPRODUCT(朝陇山), MOUNTEN(一拾山), HISTORICUS(泰拉记事社)
source
游戏资源，可选值：
https://raw.githubusercontent.com/Kengxxiao/ArknightsGameData/masterhttps://cdn.jsdelivr.net/gh/Kengxxiao/ArknightsGameData@master
安装
MCL 指令安装
./mcl --update-package xyz.cssxsh:arknights-helper --channel stable --type plugin
手动安装
- 运行 Mirai Console 生成
plugins文件夹 - 从 Releases 下载
jar并将其放入plugins文件夹中
TODO
- 配置问题类型出现的概率
- 记录答题正确率 21/06/10
- 明日方舟官方QQ表情，下载、发送更新提醒等 21/05/14
- 自定义材料掉落别名(目前由企鹅物流数据提供支持) 21/05/14
- 关卡规划
- 剿灭和周常提醒
- 游戏公告
数据来源
- 游戏数据 Kengxxiao/ArknightsGameData
- 掉落数据 企鹅物流数据统计
- 其他数据 相关API