フレンドを招待：コード、リンク、報酬

プレイヤーに見えるもの

• 「コピー」と「リンクを共有」（端末の共有シートかクリップボード）付きのプレイヤー自身の短いコード。
• コードで来てくれたフレンドの数と、その報酬のはしご。1つずつか全部受け取り。
• フレンドのコードの入力：新しいプレイヤーへのギフトを表示し、1回支払います。
• 招待リンクでログインして結び付いたプレイヤーには**「フレンドのコードで参加しました」**。
• 「まだ条件を達成中」：コードを入力したものの、まだゲームの条件を満たしていないフレンド。条件が残っている新規プレイヤーには、残りの条件と 確認 ボタンが表示されます。

仕組み

• コードは画面を開いたときにサーバーが発行します。8文字で、区切り記号と大文字小文字は無視されます。
• 招待リンクから来た新しいプレイヤーは、ログイン時に自動で招待した人と結び付きます。
• 招待がオフの間、画面はそう表示し、リクエストを送りません。
• 招待のカウント条件を設定すると、フレンドは条件を満たしたときにだけカウントされます。それまではすべて保留です：招待した人の +1 とランキングポイント、報酬ラダー、新規プレイヤーへのギフト、フレンドの支出の分配。期限はありません。
• 条件は、フレンドのログイン時、招待画面を開いたとき、トークンを入金したとき、確認 を押したときにチェックされます。

開発者向け

招待は @idosgames/core の client.referral で動きます。

// プレイヤーのコードと招待の状態を取り、新しいプレイヤーがフレンドのコードを入れる
await client.referral.getUserState()
const res = await client.referral.activateReferralCode('KD7QPX2M') // リンク全体でも動きます
if (!res.ok) return showError(res.error)
await client.referral.claimInviteRewardsBatch(['friends_1', 'friends_3'])

• activateReferralCode は、コードだけでも、プレイヤーが貼り付けたリンク全体でも受け付けます。
• 受け取れる報酬は claimInviteRewardsBatch でまとめて受け取ります。
• フレンドが待機中の間、getUserState() は QualificationPending と残りの条件を Qualification で返します。client.referral.checkQualification() はすぐにチェックします。ログイン後は SDK が待機中のプレイヤーに対してのみ自動でチェックします。

すべてのフィールドは、SDK の MCP サーバーが配るスキル referral-system に説明があります。