In-game mail: letters, rewards and gifts

What the player sees

• Tabs by category: all, rewards, gifts, system.
• A letter with its text in the player's language, the sender, a banner, rewards and a button to a screen or a page.
• "Claim" and "Claim all" in one server operation; rewards of other systems not taken yet are on top.
• "Send gifts": a free daily gift to friends ("to everyone" in one tap) and transfers of own coins or items to one friend.

How it works

• Missed rewards of other systems (a leaderboard round, a team event prize, invite rewards) are claimed right here.
• Declined or expired transfers come back to the sender.
• The server owns limits, friendship checks, expiry and what can be transferred.

For developers

The mailbox works through client.mailbox in @idosgames/core.

// Letters of a category, then claim everything waiting in one operation
const mail = await client.mailbox.getMessages({ category: 'Reward' })
const res = await client.mailbox.claimAll()
// A free daily gift to several friends at once
await client.mailbox.sendGift('daily_coins', [friendA, friendB])

• A transfer to a friend is sendTransfer; the server checks friendship and limits.
• The badge is getUnreadCount: unread letters and rewards waiting.

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