成绩指令
成绩指令
语法糖
!bs 30 = !b 1-30 = 最好的 30 个成绩，并非第 30 个成绩。
!r 0 = !r 1-100 = 最近 100 个成绩，并非第 0 个成绩。
只需要输入一个 s，就可以不用输入 1-。
只需要输入一个 0，就可以不用输入 1-100。
b，p，r 均遵守此语法。
1 绑定游戏模式 !ymmode (!sm)
如果玩家绑定了 游戏模式，那么在之后，玩家想要使用包含游戏模式参数的功能时，不需要通过输入 : + 游戏模式的方式来设定参数。机器人会自动为您补齐。
使用方法
!ymmode / !sm / !mo (游戏模式)
- 游戏模式：选填，需要绑定的 游戏模式。可输入：
- osu / o / 0： 主模式，osu!standard，osu!std
- taiko / t / 1： 太鼓模式，osu!taiko
- catch / fruits / c / 2： 接水果模式，osu!catch
- mania / m / 3： 下落模式，键盘模式，osu!mania
- 如果不输入，则会移除玩家绑定的游戏模式。此时其他功能会尝试获取玩家主页的默认游戏模式。
提示
在这里绑定的 游戏模式，可以与玩家主页的默认游戏模式，或者玩家在其他机器人内绑定的游戏模式不同。
这在同时使用多种机器人查询成绩时尤其有用。比如仅在本机器人下查询接水果模式成绩，在其他机器人下查询主模式成绩等。
2 绑定群聊游戏模式 !ymgroupmode (!gm)
如果群聊绑定了 游戏模式，那么在之后，玩家想要使用包含游戏模式参数的功能时，不需要通过输入 : + 游戏模式的方式来设定参数。机器人会自动为您补齐。
使用方法
!ymsetgroupmode / !gm (游戏模式)
- 游戏模式：选填，需要绑定的 游戏模式。同上。
- 如果不输入，则会移除群聊绑定的游戏模式。此时其他功能会尝试获取玩家绑定的游戏模式，或是玩家主页的默认游戏模式。
注意
为防止滥用，只有群聊的群主或管理员可以使用此功能。
群聊绑定的游戏模式会优先于玩家绑定的游戏模式生效。所以这个功能，应该仅用于需要控制玩家讨论游戏模式的群聊中。
3 查询最近通过成绩 !ympass (!p)
这个功能只会查询到有效（通过）的成绩。
使用方法
!ympass / p (s) (:游戏模式) (玩家名) (#偏移量或区间)
- 多成绩：如果这里添加了字母
s，Bot 会识别为多成绩模式。- 如果不输入任何参数，也能获取最近 20 个通过成绩（等价于 !p 1-20）。
- 此时，只需要输入偏移量。但是如果输入的是区间，那么加或不加
s没什么区别（!ps 100 = !p 1-100 = !ps 1-100）。 - 如果使用了 !ympass 或者 !pass，则后面需要加
es（毕竟英文复数就是这样），!p 后面只需要加s。
- 游戏模式：需要设定的默认游戏模式。请参阅： 游戏模式
- 玩家名：需要查询的玩家名称。留空默认查询自己。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@tadokoro kouji。
- 偏移量或区间：需要查询从新到老排序中的第几个或是某几个成绩。
- 可以输入 1~100 之间的整数，输入 2 就是查询最近成绩之前的那一个成绩。
- 可以输入区间，格式为：最小数
-最大数，如 1-20。
注意
为了与其他 Bot 的绑定指令区分，!pr 是无法唤起 YumuBot 的。
提示
如果不输入玩家名称（查询自己的成绩），那么偏移量前的 # 号可以忽略。
如果查询的玩家名称末尾含有空格和小于 100 的纯数字的玩家，如 osuplayer 12，建议在其后添加偏移参数 (#...)，便于区分。
示例：
- !p osuplayer 12，查询玩家 osuplayer 往前数第十二个通过成绩。
- !p osuplayer 12 #12，查询玩家 osuplayer 12 往前数第十二个通过成绩。
大多数可以忽略 # 号的参数都有这种性质。请用户注意，尽量避免获取到不想要的结果。
提示
使用 !uup 可以获取文字版消息。
使用 !pc 可以获取明信片设计。允许使用玩家名、qq= 查询。
4 查询最近成绩 !ymrecent (!r)
这个功能可以查询到失败的成绩。
使用方法
!ymrecent / r (s) (:游戏模式) (玩家名) (#偏移量或区间)
- 多成绩：如果这里添加了字母
s，Bot 会识别为多成绩模式。- 如果不输入任何参数，也能获取最近 20 个成绩（等价于 !r 1-20）。
- 此时，只需要输入偏移量。但是如果输入的是区间，那么加或不加
s没什么区别（!rs 100 = !r 1-100 = !rs 1-100）。
- 游戏模式：同上。请参阅： 游戏模式
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@tadokoro kouji。
- 偏移量或区间：同上。
注意
为了与其他 Bot 的绑定指令区分，!re 是无法唤起 YumuBot 的。
!recent 仍旧可能与其他 Bot 冲突，此时，如果玩家的绑定状态失效或者从未绑定，Bot 不会回应你。建议玩家只使用短命令 !r。
提示
使用 !uur 可以获取文字版消息。
使用 !rc 可以获取明信片设计。允许使用玩家名、qq= 查询。
5 查询谱面成绩 !ymscore (!s)
这个功能可以查询到上榜（谱面含有在线榜单，并且玩家游玩过）的成绩。
使用方法
!ymscore / s (s) (:游戏模式) [谱面编号] (玩家名) (+模组名称)
- 多成绩：如果这里添加了字母
s，Bot 会识别为多成绩模式。- 默认获取谱面所有纳入统计的成绩。
- 游戏模式：同上。请参阅： 游戏模式
- 谱面编号：必填，需要查询的谱面编号 (BID)。
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@tadokoro kouji。
- 模组名称： 模组的简称，通常为两位大写字母组成。可以无空格地输入多个 模组。
- 可输入的 模组名称：EZ、NF、HT、HR、SD、PF、DT、NC、HD、FI、FL、MR
提示
!ss 提供的多成绩，仅限于：
- Lazer 版本从开始统计 PP 以来的所有成绩
- Stable 版本在 Lazer 统计成绩之前，不同模组内的最好成绩
- Stable 版本在 Lazer 统计成绩之后的所有成绩
由于 Stable 统计特性，在 Stable 版本在 Lazer 统计成绩之前（大约 2022 年）之前所有相同模组成绩，只会保留分数最高的那个。
注意
!score 仍旧可能与其他 Bot 冲突，此时，如果玩家的绑定状态失效或者从未绑定，Bot 不会回应你。建议玩家只使用短命令 !s。
6 查询最好成绩 !ymbestperformance (!b)
这个功能可以查询到玩家最好成绩榜（BP）上的成绩。
使用方法
!ymbp / b (s) (:游戏模式) (玩家名) (查询条件) (#偏移量或区间)
- 多成绩：如果这里添加了字母
s，Bot 会识别为多成绩模式。- 如果不输入任何参数，也能获取前 20 个最好成绩（等价于 !b 1-20）。
- 此时，只需要输入偏移量。但是如果输入的是区间，那么加或不加
s没什么区别（!bs 100 = !b 1-100 = !bs 1-100）。
- 游戏模式：同上。请参阅： 游戏模式
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@tadokoro kouji。
- 查询条件：输入格式为：条件 + 运算符 + 查询内容，比如 mapper=fia。
- 条件、运算符、查询内容之间，不要留空格，并且请删去查询内容中可能含有的空格。
- 相应地，被查询内容也会移除所有空格。这与 BQ 功能的逻辑完全不一样。请注意。
- 可输入的条件种类有：
- 谱师
mapper/gder/u - 歌曲名
title/name/t - 艺术家名
artist/a - 难度名
difficulty/d - 星数
star/sr/r - 谱面编号
beatmapid/bi/id/i - 谱面集编号
beatmapsetid/si - 谱面四维
ar、cs、od、hp- 可以输入的范围：
ar、od：0-11，cs、hp：0-10
- 可以输入的范围：
- 评级
rank- 可以输入的评级：XH (SSH)、X (SS)、SH、S、A、B、C、D。
- 如果使用除了相等、完全相等、不相等之外的运算符，则会按以上所示，从左往右依次递减排序。
- 比如，输入 rank>sh，会返回评级为 SS、SSH（均在 SH 左侧，比 SH 更好）的成绩。
- 精确度
accuracy - 曲速
bpm - 连击
combo - 长度
length - 判定数量
perfect/320/305/pf、great/300/gr/良、good/200/gd、ok/100/150/可、meh/50/bad/bd、miss/0/不可/ms - 模组
mod- 可以输入任意模组简称 (2 个字母) 或它们的组合 (2n 个字母)。
- 允许按无模组 (NM)、含模组 (FM) 搜索（
CL模组除外）。 - 如果使用运算符
=，此时可以用它查询到其他复合模组，比如mod=HR也可以返回包含HDHR的成绩。 - 如果使用运算符
==，则只会返回模组数量和种类严格相等的成绩（CL模组除外）。
- 彩率 (仅 mania)
rate- 可以输入的范围：0-100
- 输入 100 默认全彩（无限大）
- 圆圈数
circle/ci/rice/rc - 滑条数
slider/sl/longnote/ln - 转盘数
spinner/sp - 物件总数
hitobject/object/total/o - 是否是转谱
convert/cv - 客户端
client/version/v/z
- 谱师
- 条件、运算符、查询内容之间，不要留空格，并且请删去查询内容中可能含有的空格。
- 备注：
- 大多数可跟随筛选条件输入的运算符：
- （约）等于
=，完全等于==，不等于!=，小于<，大于>，小于等于<=，大于等于>=。
- （约）等于
- 如果查询的条件是曲速
bpm、精确度accuracy、彩率rate，并且玩家使用等于=运算符，并输入了一个整数时：- 会按玩家输入的整数 ~ 玩家输入的整数 + 1 处理，
- 比如输入 acc=99，会返回精确度在 99%（包含）到 100%（不包含）之内的成绩。
- 如果想要查询完全与输入参数相等的成绩，请输入完全等于
==运算符。
- 大多数可跟随筛选条件输入的运算符：
- 偏移量或区间：需要查询从头到尾排序中的第几个或是某几个成绩。
- 可以输入 1~100 之间的整数，输入 2 就是查询第二个最好成绩。
- 可以输入区间，格式为：最小数
-最大数，如 1-20。
注意
!bp 仍旧可能与其他 Bot 冲突，此时，如果玩家的绑定状态失效或者从未绑定，Bot 不会回应你。建议玩家只使用短命令 !b。
提示
如果不输入玩家名称（查询自己的成绩），那么偏移量前的 # 号可以忽略。
如果查询的玩家名称末尾含有空格和小于 100 的纯数字的玩家，如 osuplayer 12，建议在其后添加偏移参数 (#...)，便于区分。
7 查询今日最好成绩 !ymtodaybp (!t)
这个功能可以查询到玩家今天（或直到距今天多少天前）最好成绩榜（BP）上新增的成绩。
使用方法
!ymtodaybp / t (:游戏模式) (玩家名) (#天数)
- 游戏模式：同上。请参阅： 游戏模式
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@tadokoro kouji。
- 天数：查询距今多少天内，玩家新增的最好成绩。
- 可以输入 1~999 之间的整数。输入 30 就是距今 30 天内。
注意
!todaybp 仍旧可能与其他 Bot 冲突。建议玩家只使用短命令 !t。
提示
如果不输入玩家名称（查询自己的信息），则天数前的 # 号可以忽略。
如果查询的其他玩家名称含有以下容易引起混淆的条件时，建议在其后添加天数参数 (#...)，便于区分。
- 名称为纯数字，且值小于 999 的玩家。如 970。
- 名称末尾含有空格和小于 999 的纯数字的玩家，如 osuplayer 123。
示例：
- !t 970：查询自己 970 天内新增的最好成绩。
- !t 970 #1 查询一个叫 970 的玩家，在今天内新增的最好成绩。
8 分析最好成绩 !ymbpanalysis (!ba)
这个功能可以分析玩家的最好成绩榜，从而判断玩家目前的状态，以及玩家的偏好或技巧。
使用方法
!ymbpanalysis / ba (:游戏模式) (玩家名)
- 游戏模式：同上。请参阅： 游戏模式
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@tadokoro kouji。
内容解析
内容解析
- Top 5 BPs：玩家 BP 前五位。
- Last 5 BPs：玩家 BP 末五位。
- Mods：玩家 BP 内 模组的分布情况。
- 靠中间的 饼图下方依次是各个 模组的名称、 数量（灰色字）以及所占 PP（加权后）。这个 PP 越高，说明玩家在这个 模组上越熟练。
- BP Distribution：BP 分布情况。
- 标题右侧是玩家的该模式 总 PP，括号里的灰色字是 谱面 PP + 奖励 PP（Bonus PP）。灰色字下方是该 游戏模式。
- 下方的 折线图反映了玩家 BP 成绩的 PP 分布。
- 下方的 条形图反映了玩家 BP 成绩的 时长（高度）以及 评级（颜色）分布。
- Length、Combo、Star Rating：分析玩家 BP 内 时长、 连击数、 星数的分布情况。
- 带有 图标的指对应值的最大值。相应地， 指最小值， 指中位数（不是平均数！）。
- 每个图标最下面的 图片即代表了对应的成绩。
- 图片 左上方的 圆圈表示 星数（SR）。
- 图片 右上方的 圆圈表示 评级（Ranking）。
- Favorite Mappers：最喜爱的 谱师分布情况。
- 标题右侧指明了玩家的 BP 上， 谱师数量总计。
- 谱师名称下方依次是各个谱师所制作的谱面的 成绩数量，以及所占 PP（加权后）。这个 PP 越高，说明玩家越能刷这个谱师制作的谱面。
- Ranks：玩家 BP 内 评级（Ranking）的名称、数量以及所占 PP（加权后，灰字）。
注意
!bpa 仍旧可能与其他 Bot 冲突，此时，如果玩家的绑定状态失效或者从未绑定，Bot 不会回应你。建议玩家只使用短命令 !ba。
提示
使用 !al (!bal) 可以获取上一个版本的设计。
使用 !ua (!uai) 可以获取文字版消息。
并且，据说输入某个老师和学生深入交流的游戏英文名，也可以调出此功能哦？
9 修补最好成绩 !ymbpfix (!bf)
这个功能可以分析玩家的最好成绩榜，抽出玩家的不完美 (choke) 成绩，并预测当这些成绩被修补成全连 (full combo) 后，玩家能获得多少表现分。
使用方法
!ymbpf / bf (:游戏模式) (玩家名)
- 游戏模式：同上。请参阅： 游戏模式
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@tadokoro kouji。
注意
繁重功能，如果您是第一次查询，结果将会在 15-30 秒内返回。如果 Bot 消息发送失败，请稍后再重试，切勿刷屏查询。
提示
这个功能对于太鼓和键盘模式玩家用处不大，因为失误数量对最好成绩榜的影响，远远不如准确率 (accuracy) 的高低。
同样地，这个功能对于刷 SS 的玩家用处也不大，因为最好成绩榜无需修补。
主模式更新后，失误数量也没什么影响了。所以说...