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

プレイヤーに見えるもの

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

仕組み

• コードは画面を開いたときにサーバーが発行します。8文字で、区切り記号と大文字小文字は無視されます。
• 招待リンクから来た新しいプレイヤーは、ログイン時に自動で招待した人と結び付きます。
• 招待がオフの間、画面はそう表示し、リクエストを送りません。

開発者向け

招待は @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 でまとめて受け取ります。

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