成绩指令
成绩指令
语法糖
!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 (游戏模式)
- 游戏模式：选填，需要绑定的 游戏模式。同上。
- 如果不输入，则会移除群聊绑定的游戏模式。此时其他功能会尝试获取玩家绑定的游戏模式，或是玩家主页的默认游戏模式。
注意
为防止滥用，只有群聊的群主或管理员可以使用此功能。
注意
群聊绑定的游戏模式，会优先于玩家绑定的游戏模式生效。所以这个功能，应该仅用于需要控制玩家讨论游戏模式的群聊中。
游戏模式的获取先后顺序：
群聊游戏模式 > 玩家绑定的游戏模式 > 玩家主页上的默认游戏模式 (通常是 osu!standard)
比如，一个玩家的主页游戏模式为 osu!standard，并且自己绑定的游戏模式为 osu!taiko。那么他在一个设定默认模式为 osu!mania 的群聊内查询时，会返回以下结果：
- 不带游戏模式参数（
:）查询：会返回 osu!mania 模式内的结果，无视玩家自己绑定的游戏模式。 - 带游戏模式参数（
:）查询：会返回这个参数对应的模式内的结果。
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。
- 支持使用 @ 查询，输入格式为：@nana7michan。
- 查询条件：请参阅： 查询条件·成绩查询器
- 偏移量或区间：需要查询从新到老排序中的第几个或是某几个成绩。
- 可以输入 1~100 之间的整数，输入 2，就是查询最近的通过成绩的前一个通过成绩。
- 可以输入区间，格式为：最小数
-最大数，如 1-20。 - 如果输入 0，则默认为 1~100。
注意
为了与其他 Bot 的绑定指令区分，!pr 是无法唤起 YumuBot 的。
提示
如果不输入玩家名称（查询自己的成绩），那么偏移量前的 # 号可以忽略。
如果查询的玩家名称末尾含有空格和小于 100 的纯数字的玩家，如 osuplayer 12，建议在其后添加偏移参数 (#...)，便于区分。
示例：
- !p osuplayer 12，查询玩家 osuplayer 往前数第十二个通过成绩。
- !p osuplayer 12 #12，查询玩家 osuplayer 12 往前数第十二个通过成绩。
大多数可以忽略 # 号的参数都有这种性质。请用户注意，尽量避免获取到不想要的结果。
提示
使用 !pw 可以获取适合视频封面使用的设计。
提示
使用 !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。
- 支持使用 @ 查询，输入格式为：@nana7michan。
- 查询条件：请参阅： 查询条件·成绩查询器
- 偏移量或区间：需要查询从新到老排序中的第几个或是某几个成绩。
- 可以输入 1~100 之间的整数，输入 2，就是查询最近成绩的前一个成绩。
- 可以输入区间，格式为：最小数
-最大数，如 1-20。 - 如果输入 0，则默认为 1~100。
注意
为了与其他 Bot 的绑定指令区分，!re 是无法唤起 YumuBot 的。
!recent 仍旧可能与其他 Bot 冲突，此时，如果玩家的绑定状态失效或者从未绑定，Bot 不会回应你。建议玩家只使用短命令 !r。
提示
使用 !rw 可以获取适合视频封面使用的设计。
使用 !uur 可以获取文字版消息。
使用 !rc 可以获取明信片设计。
5 查询谱面成绩 !ymscore (!s)
这个功能可以查询到上榜（谱面含有在线榜单，并且玩家游玩过）的成绩。
使用方法
!ymscore / s (s) (:游戏模式) (谱面编号或成绩编号) (玩家名) (+模组名称)
- 多成绩：如果这里添加了字母
s，Bot 会识别为多成绩模式。- 默认获取谱面所有纳入统计的成绩。
- 游戏模式：同上。请参阅： 游戏模式
- 谱面编号或成绩编号：需要查询的谱面编号 (BID) 或成绩编号 (SCORE_ID)。
- 如果不输入编号，则默认获取玩家最近成绩的谱面，从而获取到玩家在谱面内的 pp 最高成绩（类似于 !r)。
- 如果输入成绩编号，则其他参数均无效（因为一个成绩编号只对应一个确定的成绩）。
- 默认将编号 100000000 及以上视为成绩编号，而 100000000 以下的会被视为谱面编号。
- 编号 100000000 的成绩是一个 2013 年的成绩。因此，对于在这之前的成绩，暂时无法通过成绩编号查询。
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@nana7michan。
- 模组名称： 模组的简称，通常为两位大写字母组成。可以无空格地输入多个 模组。
- 可输入的 模组名称：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。
- 支持使用 @ 查询，输入格式为：@nana7michan。
- 查询条件：请参阅： 查询条件·成绩查询器
- 偏移量或区间：需要查询从头到尾排序中的第几个或是某几个成绩。
- 可以输入 1~200 之间的整数，输入 102 就是查询第 102 个最好成绩。
- 可以输入区间，格式为：最小数
-最大数，如 1-20。 - 如果输入 0，则默认为 1~100。
注意
!bp 仍旧可能与其他 Bot 冲突，此时，如果玩家的绑定状态失效或者从未绑定，Bot 不会回应你。建议玩家只使用短命令 !b。
提示
使用 !bw 可以获取适合视频封面使用的设计。
提示
如果不输入玩家名称（查询自己的成绩），那么偏移量前的 # 号可以忽略。
如果查询的玩家名称末尾含有空格和小于 100 的纯数字的玩家，如 osuplayer 12，建议在其后添加偏移参数 (#...)，便于区分。
7 查询今日最好成绩 !ymtodaybp (!t)
这个功能可以查询到玩家今天（或直到距今天多少天前）最好成绩榜（BP）上新增的成绩。
使用方法
!ymtodaybp / t (:游戏模式) (玩家名) (#天数)
- 游戏模式：同上。请参阅： 游戏模式
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@nana7michan。
- 天数：查询距今多少天内，玩家新增的最好成绩。
- 可以输入 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。
- 支持使用 @ 查询，输入格式为：@nana7michan。
内容解析
内容解析
- 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（加权后，灰字）。
提示
使用 !al (!bal) 可以获取上一个版本的设计。
使用 !ua (!uai) 可以获取文字版消息。
并且，据说输入某个老师和学生深入交流的游戏英文名，也可以调出此功能哦？
9 修补最好成绩 !ymbpfix (!bf)
这个功能可以分析玩家的最好成绩榜，抽出玩家的不完美 (choke) 成绩，并预测当这些成绩被修补成全连 (full combo) 后，玩家能获得多少表现分。
使用方法
!ymbpf / bf (:游戏模式) (玩家名)
- 游戏模式：同上。请参阅： 游戏模式
- 玩家名：同上。
- 支持使用 QQ 查询，输入格式为：qq=114514。
- 支持使用 UID 查询，输入格式为：uid=1919810。
- 支持使用 @ 查询，输入格式为：@nana7michan。