用户名与好友系统

为什么需要这套系统？

在 QQ 平台上，Bot 存在一个限制：无法读取消息中的 @ 数据。这意味着你无法像在其他平台一样，通过 @ 某人来查询他的成绩。

同时，McMai 内部使用的用户 ID 对普通用户并不可见，手动输入也非常麻烦。

为了解决这个问题，McMai 引入了用户名与 QQ 号绑定机制：用户只需设置一个易记的用户名（或绑定 QQ 号），其他人就可以通过 #用户名 或 #QQ号 来指定查询目标。

但用户名毕竟可能不好记、或者会被修改——这时好友系统就派上用场了：将常用玩家添加为好友后，直接用 #好友1 即可查询，无需记忆用户名，且对方修改用户名后也不受影响。

---

用户名

用户名有什么用？

设置用户名后，你就拥有了一个在 McMai 中可被他人识别的身份标识：

• 他人可以通过 #用户名 查询你的数据，例如 /b50 #MaiPlayer
• 他人可以通过用户名将你添加为好友

TIP

用户名是在 QQ 平台上让他人查询你、添加你的主要方式。如果你希望被群友查询或 PK，建议优先设置用户名。

如何设置用户名？

指令： /用户名 <用户名>

规则：

• 长度 5～10 个字符
• 支持汉字、英文字母、数字的组合，但不能为纯数字
• 全局唯一，不能与他人重复
• 设置后需等待 3 天 才能再次修改，请谨慎选择

指令	说明
/用户名 MaiPlayer	将用户名设置为 MaiPlayer
/用户名 清除	删除当前用户名
/用户名	查看当前用户名与 QQ 绑定状态

---

绑定 QQ 号

QQ 号绑定有什么用？

绑定 QQ 号是用户名之外的另一种身份标识方式，主要面向国服用户：

• 国服用户绑定 QQ 号后，Bot 可通过水鱼查分器拉取你的国服成绩数据，部分功能依赖此绑定才能正常使用
• 其他用户可以通过 #QQ号 查询你或将你添加为好友，作为用户名之外的备用方式

国服用户专属

日服 / 国际服用户通过 SEGA ID 绑定账号，无需绑定 QQ 号。

如何绑定 QQ 号？

将你的 QQ 号（5～11 位数字）作为参数传入，系统会自动识别为 QQ 号绑定操作，不会误判为用户名。

指令： /用户名 <QQ号>

指令	说明
/用户名 123456789	绑定 QQ 号 123456789
/用户名 解绑qq	解除 QQ 号绑定

---

好友系统

好友系统有什么用？

用户名虽然解决了"如何找到别人"的问题，但仍有不便之处：

• 用户名可能较长或不好记
• 对方修改用户名后，你需要重新记住新的用户名

好友系统正是为此设计的。你可以将常用玩家保存到最多 3 个好友槽位中，之后：

• 直接用 #好友1、#好友2、#好友3 查询好友数据，无需记忆用户名
• 使用 /info 指令可一键展示你与所有好友的当前成绩概况
• 对方修改用户名后，好友查询不受影响，系统始终追踪对应账号
• 可随时对好友发起 B50 PK 对比

如何管理好友？

指令： /好友

指令	说明
/好友 列表	查看当前 3 个好友槽位
/好友 添加 #用户名	通过用户名添加好友（自动填入第一个空槽）
/好友 添加 #用户名 2	添加好友到指定槽位（会覆盖原有）
/好友 添加 #QQ号	通过 QQ 号添加好友
/好友 删除 1	删除槽位 1 的好友

如何使用好友槽位查询？

添加好友后，在任意支持指定查询目标的指令中，用 #好友N 代替用户名即可：

指令示例	说明
/b50 #好友1	查看好友 1 的 Best 50
/info	一键查看自己与所有好友的成绩概况
/pk50 #好友1	与好友 1 进行 B50 PK 对比

多语言支持

好友槽位也支持英文（#friend1）和日文（#フレンド1）写法，效果相同。

---

成绩 PK（pk50）

/pk50 指令可以将你的 Best 50 成绩与对方进行对比：以你的 B50 曲目为基准，在对方成绩中找出命中的谱面，分别计算双方在这些谱面上的 Rating 值并判定胜负。

指令： /pk50 <目标>

指令示例	说明
/pk50 #MaiPlayer	与指定用户名的玩家 PK
/pk50 #好友1	与好友 1 PK

注意

发起 PK 前，双方均需已更新 B50 数据（/更新b50 或 /更新记录），且对方的 B50 隐私权限需为公开。

---

查询目标指定方式

McMai 中大多数查询指令支持在末尾附加目标参数，来查询指定玩家而非自己：

写法	说明
（不填）	默认查询自己
#用户名	通过用户名查询
#QQ号	通过 QQ 号查询（对方需已绑定 QQ）
#好友1 / #好友2 / #好友3	查询好友槽位对应的玩家

解析优先级：#好友N > #用户名 > #QQ号 > 默认（自己）