Invite friends: codes, links and rewards

What the player sees

• The player's own short code with "Copy" and "Share link" (the system share sheet or the clipboard).
• How many friends came by the code and the reward ladder for them, claim one or all.
• Entering a friend's code: shows the newcomer's gift and pays it once.
• "You joined by a friend's code" for a player bound at sign-in by an invite link.

How it works

• The server mints the code when the screen opens; 8 letters, separators and case are ignored.
• A newcomer who came by an invite link is bound to the inviter at sign-in by itself.
• While invites are off, the screen says so and sends no request.

For developers

Invites work through client.referral in @idosgames/core.

// The player's code and invite state, then a friend's code from a newcomer
await client.referral.getUserState()
const res = await client.referral.activateReferralCode('KD7QPX2M') // a whole link works too
if (!res.ok) return showError(res.error)
await client.referral.claimInviteRewardsBatch(['friends_1', 'friends_3'])

• activateReferralCode takes a bare code or the whole link a player pasted.
• Claim every ready reward at once with claimInviteRewardsBatch.

Every field is described in the referral-system skill, served by the SDK MCP server.