친구 초대: 코드, 링크, 보상

플레이어가 보는 것

• "복사"와 "링크 공유"(시스템 공유 창 또는 클립보드)가 있는 플레이어 본인의 짧은 코드.
• 코드로 온 친구 수와 그에 따른 보상 사다리, 하나씩 또는 모두 받기.
• 친구 코드 입력: 신규 플레이어 선물을 보여 주고 한 번 지급합니다.
• 초대 링크로 로그인할 때 연결된 플레이어에게 "친구 코드로 참여했어요".

작동 방식

• 서버는 화면이 열릴 때 코드를 만듭니다. 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 스킬에 설명되어 있습니다.