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

플레이어가 보는 것

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

작동 방식

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