ユーザー名とフレンドシステム

なぜこのシステムが必要なのか？

QQ プラットフォームでは、Bot に一つの制限があります：メッセージ内の @ メンションデータを読み取れません。そのため、他のプラットフォームのように誰かをメンションしてスコアを照会することができません。

また、McMai が内部で使用するユーザー ID は一般ユーザーには見えず、手動入力も非常に不便です。

この問題を解決するため、McMai ではユーザー名と QQ 番号連携の仕組みを導入しています。ユーザー名を設定する（または QQ 番号を連携する）と、他のユーザーが #ユーザー名 や #QQ番号 を使ってあなたを照会対象に指定できるようになります。

ただし、ユーザー名は覚えにくかったり変更されることもあります。そこでフレンドシステムが役立ちます。よく照会するプレイヤーをフレンドとして登録すれば、#フレンド1 だけで簡単に照会でき、相手がユーザー名を変更しても影響を受けません。

---

ユーザー名

ユーザー名の用途は？

ユーザー名を設定すると、McMai 内で他のユーザーから識別できる ID が持てます：

• 他のユーザーが #ユーザー名 でデータを照会できます（例：/b50 #MaiPlayer）
• ユーザー名でフレンド追加もできます

TIP

ユーザー名は QQ 上で他のプレイヤーに照会・追加してもらうための主な手段です。グループメンバーに照会・PK してもらいたい場合は、まずユーザー名を設定しましょう。

ユーザー名の設定方法

コマンド： /用户名 <ユーザー名>

ルール：

• 5〜10 文字
• 漢字・英数字の組み合わせ可（純粋な数字のみは不可）
• グローバルで一意（他のユーザーと重複不可）
• 設定後は 3日間 変更不可 — 慎重に選んでください

コマンド	説明
/用户名 MaiPlayer	ユーザー名を MaiPlayer に設定
/用户名 清除	ユーザー名を削除
/用户名	現在のユーザー名と QQ 連携状態を確認

---

QQ 番号連携

QQ 番号連携の用途は？

QQ 番号連携はユーザー名とは別の身元確認手段で、主に CN サーバーユーザー向けです：

• 連携後、Bot が Diving Fish スコアトラッカー経由で CN サーバーのデータを取得できるようになります（一部機能はこの連携が必要です）
• ユーザー名がない場合の代替として、#QQ番号 で照会・フレンド追加が可能になります

CN サーバーユーザー専用

JP / INTL ユーザーは 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 と PK 対戦

多言語対応

フレンドスロットは中国語（#好友1）と英語（#friend1）表記にも対応しています。

---

スコア 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番号 > デフォルト（自分）