使用者名稱與好友系統
為什麼需要這套系統？
在 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號碼 > 預設（自己）