ゲーム内メール：手紙、報酬、ギフト

プレイヤーに見えるもの

• カテゴリーのタブ：すべて、報酬、ギフト、システム。
• プレイヤーの言語の本文、差出人、バナー、報酬、画面やページへのボタンが付いた手紙。
• サーバー操作1回で行う**「受け取る」と「すべて受け取る」**。ほかのシステムのまだ受け取っていない報酬が上に来ます。
• 「ギフトを贈る」：フレンドへの毎日の無料ギフト（ワンタップで「全員に」）と、1人のフレンドへの自分のコインやアイテムの送付。

仕組み

• ほかのシステムで受け取り損ねた報酬（ランキングのラウンド、チームイベントの賞品、招待の報酬）は、ここでそのまま受け取れます。
• 断られたり期限が切れたりした送付は、送った人に戻ります。
• 上限、フレンド関係の確認、期限、何を送れるかはサーバーの担当です。

開発者向け

メールボックスは @idosgames/core の client.mailbox で動きます。

// カテゴリーの手紙を取り、待っているものを1回の操作で受け取る
const mail = await client.mailbox.getMessages({ category: 'Reward' })
const res = await client.mailbox.claimAll()
// 複数のフレンドにまとめて毎日の無料ギフト
await client.mailbox.sendGift('daily_coins', [friendA, friendB])

• フレンドへの送付は sendTransfer です。フレンド関係と上限はサーバーが確認します。
• バッジは getUnreadCount：未読の手紙と受け取れる報酬。

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