比赛指令
比赛指令
1 查询比赛信息 !ymmatch (!ma)
备注
暂未开放
2 查询比赛斗力（评分） !ymrating (!mra/ra)
通过分析比赛所有对局，来给玩家赋予一个斗力（表现评分）。
使用方法
!ymrating / mra / ra [比赛编号] (eEasy 倍率) (跳过开头) (忽略结尾) ([筛除对局]) (f) (r)
- 比赛编号：必填，需要查询的比赛编号 (MATCHID)。
- 获取方法：进入房间，点击 #multiplayer 下，BanchoBot 发送的第一条消息中的蓝色 here。之后，在弹出的网站内找到网站链接末尾的数字，即比赛编号 (MATCHID)。
- Easy 倍率：如果您的比赛对于 Easy 模组有分数加成，请填写此字段（开头加 e）。
- 允许填写 0~20 内的数字（允许小数）。比如：e 1.8。
- 如不填写，默认为 1（不修改）。
- 跳过开头：需要跳过的开头对局数量。这适用于比赛含有热手等不需要统计玩家表现的开头对局。
- 如不填写，默认为 0。想要输入忽略结尾的参数时，也可输入 0 来占位。
- 忽略结尾：需要忽略的结尾对局数量。这适用于比赛含有决胜局表演或娱乐局等不需要统计玩家表现的结尾对局。
- 如不填写，默认为 0。
- 筛除对局：如果您并不能仅依靠以上两个操作就能实现筛除无用对局的目标，也可以输入要筛除的对局所对应的位置。
- 格式为中括号
[]括起来的数组。从 1 开始。- 比如 !ymra matchID [1, 2, 3] = 筛去前三场 = !ymra matchID 3。
- 可与以上两个功能搭配使用。
- 比如 !ymra matchID [1, 2, 3] = !ymra matchID 2 [3]。
- 格式为中括号
- f：如果填入 f，则表示统计玩家低于 1 万分的成绩。
- 如不填写，默认忽略玩家低于 1 万分的成绩（默认去除房间内的裁判）。
- r：如果填入 r，则表示忽略重复的对局，只保留靠后的那一场。
- 如不填写，默认统计重复的对局。
内容解析
内容解析
- 左上角的比赛信息卡片：
- 卡片左上角是比赛的 房间标题。
- 卡片左下角依次是 对局数量、 比赛时间区间以及 比赛日期。
- 卡片右下角依次是比赛 平均星数、 比赛编号以及 计分板。
- 玩家个人信息卡片：
- 卡片左侧是玩家的 队伍颜色和 头像。
- 卡片中间靠左依次是玩家的 昵称、 比赛总分（总输出）、 胜负和胜率、 玩家评分排名和 RWS。
- RWS 指 平均胜利分配（(average) Rounds Win Share），即为了所属队伍的胜利做出了多少贡献。有时候玩家评分很高，但不一定很有用。
- 想要了解更多，请参考 这篇文章。
- 卡片中间靠右是 玩家类型和 玩家评分。
- 玩家类型：见下。
- 玩家评分：只需要记住：平均分是 1 分，毫无参与感的玩家是 0 分。
玩家类型详解
在 MRA v1.2 中，玩家被分为 11 个基础类型。
| 总分/均分 | 高 | 中 | 低 |
|---|---|---|---|
| 高 | ⬤ 大哥 | ⬤ 打工 | ⬤ 抗压 |
| 中 | ⬤ 主力 | ⬤ 普通 | ⬤ 背锅 |
| 低 | ⬤ 专精 | ⬤ 客串 | ⬤ 小弟 |
总分最靠前、均分最靠前的 ⬤ 大哥即 ⬤ 大爹，总分最靠后、均分最靠后的 ⬤ 小弟即 ⬤ 炮灰。
- ⬤ 大爹：强。
- ⬤ 大哥：均分高，总分高。不管输赢与否，已经把自己的实力完全发挥出来了。是队伍的主心骨。
- ⬤ 主力：均分高，总分中。上场相比于大哥稍微低了点，但在大部分对局中，仍旧能够撑起场面。
- ⬤ 专精：均分高，总分低。能在自己擅长的谱面上发挥较好的玩家，能够打对手一个措手不及，拿下关键对局。
- ⬤ 打工：均分中，总分高。发挥尚可的全能玩家，通常会去填补阵容中的空缺位置。如果赢下了对局，那就是值得的。否则，等同于打白工。
- ⬤ 普通：均分中，总分中。代表了这一场比赛的平均水平。如果最后他们的总评分约等于 1.0，那就是纯正的比赛质检员了。
- ⬤ 客串：均分中，总分低。偶尔上场的玩家，至少打出来的分数达到了平均分。
- ⬤ 抗压：均分低，总分高。非常罕见的类型。可以说，他们是真正的“全面型玩家”，但什么都会，也可能等于什么都不精通。
- ⬤ 背锅：均分低，总分中。赢了和他们没关系，输了都怪他们。
- ⬤ 小弟：均分低，总分低。他们可能不属于这个分段，也可能是没发挥出来，手感不好。
- ⬤ 炮灰：菜。
在 MRA v3.4 中，根据贡献 (RWS)，玩家被更加细致地分为 33 个扩展类型，力求给玩家最精准的评价。
| 玩家类型/RWS | ✔️贡献高 | ➖贡献中 | ❌贡献低 |
|---|---|---|---|
| ⬤ 大爹 | 最强元帅 | 称职元帅 | 不屈元帅 |
| ⬤ 大哥 | 常胜将军 | 勤奋将军 | 尽力将军 |
| ⬤ 主力 | 突破主力 | 可靠主力 | 坚守主力 |
| ⬤ 专精 | 精锐刺客 | 普通刺客 | 冒牌刺客 |
| ⬤ 打工 | 金领工人 | 白领工人 | 蓝领工人 |
| ⬤ 普通 | 关键人 | 普通人 | 路人甲 |
| ⬤ 客串 | 主要角色 | 次要角色 | 群众演员 |
| ⬤ 抗压 | 稳如泰山 | 坚若磐石 | 伤痕累累 |
| ⬤ 背锅 | 上等忍者 | 普通忍者 | 不入流 |
| ⬤ 小弟 | 幸运儿 | 合格学徒 | 初学者 |
| ⬤ 炮灰 | 救命稻草 | 点点星火 | 湮灭尘埃 |
提示
使用 !ura 可以获取文字版消息。
使用 !cra 可以获取逗号分隔文件 (csv)，可以被 Excel 系列软件读取。
使用 !crx/!crs 可以获取另一个格式的逗号分隔文件 (csv)，并且可以输入多场比赛。
只有管理员或群主可以使用这一部分功能。
由于框架变动，目前 Bot 暂时无法发送文件。如果你需要使用相应功能，请询问开发组成员。
3 查询系列比赛斗力（评分） !ymseries (!sra/sa)
通过分析一系列比赛的所有对局，来给玩家赋予一个斗力（表现评分）。
使用方法
!ymseries / sra / sa (#比赛名称#) [[比赛编号] (跳过开头) (忽略结尾) ([筛除对局])]... (eEasy 倍率) (f) (r)
- 比赛名称：选填，这个名字将展现在左上角的卡片中。不填默认显示第一场比赛的名称。
- 比赛编号：同上，必填，需要查询的比赛编号 (MATCHID)。
- Easy 倍率：同上，选填，如果您的比赛对于 Easy 模组有分数加成，请填写此字段（开头加 e）。
- 跳过开头：同上，选填，需要跳过的开头对局数量。
- 如不填写，默认为 0。想要输入忽略结尾的参数时，也可输入 0 来占位。
- 忽略结尾：同上，选填，需要忽略的结尾对局数量。
- 如不填写，默认为 0。
- 筛除对局：同上，选填，如果您并不能仅依靠以上两个操作就能实现筛除无用对局的目标，也可以输入要筛除的对局所对应的位置。
- f：如果填入 f，则表示统计玩家低于 1 万分的成绩。
- 如不填写，默认忽略玩家低于 1 万分的成绩。
- r：如果填入 r，则表示忽略重复的对局，只保留靠后的那一场。
- 如不填写，默认统计重复的对局。
提示
需要按组输入 比赛编号、 跳过开头和 忽略结尾、 筛除对局参数。当然，也可以不输入（默认为 0）。
举例：
- !sa 114514 0 0 1919810 0 1
合法，效果等同于 !ra 114514 0 0 + !ra 1919810 0 1 合起来统计的比赛斗力（评分）。
- !sa 114514 1919810 0 1 7355608 1 2147483647 2 r
照样合法，等同于 !ra 114514 0 0 r + !ra 1919810 0 1 r + !ra 7355608 1 0 r + !ra 2147483647 2 0 r。
f 和 r 参数是全局性的，它们会作用到这一系列赛的所有比赛中。
使用 !usa 可以获取文字版消息。但不推荐（因为会刷屏）。
使用 !csa 可以获取逗号分隔的文件 (csv)，可以被 Excel 系列软件读取。
只有管理员或群主可以使用这一部分功能。
由于框架变动，目前 Bot 暂时无法发送文件。如果你需要使用相应功能，请询问开发组成员。
注意
繁重功能，查询结果将会在 10-20 秒内返回。如果 Bot 消息发送失败，请稍后再重试，切勿刷屏查询。
4 监听比赛房间 !ymmatchlisten (!ml)
监听比赛房间，并在比赛开始时给出提示，对局结束时输出 比赛对局信息（MR 功能）。
使用方法
!ymmatchlisten / ml / li [比赛编号] (操作)
- 比赛编号：同上。
- 操作：开始或停止监听房间的操作。
- 可输入 start、stop、end、on、off、s、p、e、o、f。
- 如不填写，默认开始监听（start）。
注意
监听过程有可能被中断。可能出现的情况有：
- 比赛正常结束：房间关闭。
- 因为 30 分钟内没有新对局活动（没打图），所以比赛房间被 Bancho 强行关闭。
- 因为房间内所有玩家均已经离开，所以非指令创建的比赛房间被关闭。
- 比赛房间的管理员使用 !mp close 关闭了比赛房间。
- 调用者关闭：您使用了 !ml matchid off 停止监听。
- 超级管理员关闭：超级管理员使用了 !ml matchid off 停止监听。
- 服务器重启：YumuBot 服务器需要执行重启任务。
- 超时：监听总时长超过了 6 小时。
监听中断后，只要比赛还在继续，用户就可以无条件重新启动新一轮的监听。
注意
如以上所提到：
为了避免刷屏，单次监听时长最长只有 6 个小时。并且，单人只能同时监听 3 个不同的比赛房间，同一个群聊也只能同时监听 3 个不同的比赛房间。
如果超出限制，Bot 将会提示。
5 获取比赛结果 !ymmatchnow (!mn)
输出一张比赛房间内的全览图。
使用方法
!ymmatchnow / mn [比赛编号] (跳过开头) (忽略结尾) (f) (r)
- 比赛编号：同上。
- 跳过开头：同上。
- 忽略结尾：同上。
- f：如果填入 f，则表示统计玩家低于 1 万分的成绩。
- 如不填写，默认忽略玩家低于 1 万分的成绩。
- r：如果填入 r，则表示忽略重复的对局，只保留靠后的那一场。
- 如不填写，默认统计重复的对局。
提示
此功能的参数和 ra 完全一致。记住一个即可。
6 查看对局信息 !ymmatchround (!mr/ro)
输出一张比赛房间内的某场对局图。
使用方法
!ymmatchround / mr / ro [比赛编号] (对局位置) (关键字)
- 比赛编号：同上。
- 对局位置：需要查询的对局场次位置。
- 可以输入一个整数。输入 2 就是从开始算起第二局。
- 关键字：如果不知道具体的对局位置，可以忽略，并填写关键字的字段。
- 关键字查询范围：谱面的歌曲名称（罗马音）、艺术家名称（罗马音）、谱师名称、难度名称。
- 如果关键字是很小的数字，则会被匹配进对局位置中。请注意。
7 生成图池图片 !ymgetpool (!getpool)
根据输入的模组名称和谱面编号，输出一张可供比赛展示的谱面信息集合图（图池），方便选手查阅。
使用方法
!ymgetpool / gp (#比赛名称#) [[模组] [谱面编号]]...
- 比赛名称：选填，这个名字将展现在左上角的卡片中。
- 模组：同上，必填，模组池。
- 必须为两个大写字母。
- 如果模组池的模组会改变 星数（比如 DT），则谱面的 星数等属性会自动随之更改。
- 必须输入在谱面编号之前。且之后必须至少跟随 1 个谱面编号。
- 谱面编号：同上，必填，输入的谱面 (BID)。
提示
需要按组输入 模组、 谱面编号。并且，至少需要输入 1 个模组，且之后必须至少跟随 1 个谱面编号。
举例：
- !gp #AMYC S1 R2# NM 2903091 3546768
合法，此时有 1 个模组池 NM，内有 2 张谱面。
- !gp #AMYC S1 R2# NM 2903091 3546768 HD 1674334 HR
不合法，模组池 HR 内没有谱面。
- !gp #AMYC S1 R2# 2903091 3546768
不合法，没有输入模组池。
备注
预览版功能，结果暂不完整。
## 8 读取图池 !ymmappool (!po) {id=pool}
根据输入的图池编号，读取数据库内已经记录好的图池。
使用方法
!ymmappool / po (id=图池编号) (图池名称)
- 图池编号：选填，图池的编号。
- 图池名称：选填，图池的名字。如果无法匹配则会返回最接近的结果（？）。
- 如果两个参数均留空，Bot 会提供一张包含所有图池的图片。
备注
预览版功能，结果暂不完整。