readme.md

Arknights Helper

基于 Mirai Console 的 明日方舟 助手插件

使用前应该查阅的相关文档或项目

• User Manual
• Permission Command
• Chat Command

指令

注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/抽卡 十连
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数

本插件指令权限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的公招干员

works的数量为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(泰拉记事社)

安装

MCL 指令安装

./mcl --update-package xyz.cssxsh:arknights-helper --channel stable --type plugin

手动安装

1. 运行 Mirai Console 生成plugins文件夹
2. 从 Releases 下载jar并将其放入plugins文件夹中

TODO

• 配置问题类型出现的概率
• 记录答题正确率 21/06/10
• 明日方舟官方QQ表情，下载、发送更新提醒等 21/05/14
• 自定义材料掉落别名(目前由企鹅物流数据提供支持) 21/05/14
• 关卡规划
• 剿灭和周常提醒
• 游戏公告

数据来源

• 游戏数据 Kengxxiao/ArknightsGameData
• 掉落数据 企鹅物流数据统计
• 其他数据 相关API