게임 속 우편: 편지, 보상, 선물

플레이어가 보는 것

• 카테고리 탭: 전체, 보상, 선물, 시스템.
• 플레이어 언어로 된 본문, 보낸 사람, 배너, 보상, 화면이나 페이지로 가는 버튼이 있는 편지.
• 서버 작업 한 번으로 하는 "받기"와 "모두 받기". 다른 시스템에서 아직 받지 않은 보상이 위에 있습니다.
• "선물 보내기": 친구에게 주는 무료 일일 선물(한 번에 "모두에게")과 친구 한 명에게 내 코인이나 아이템 전달.

작동 방식

• 다른 시스템에서 놓친 보상(리더보드 라운드, 팀 이벤트 상품, 초대 보상)을 바로 여기서 받습니다.
• 거절되거나 만료된 전달은 보낸 사람에게 돌아옵니다.
• 한도, 친구 관계 확인, 만료, 무엇을 전달할 수 있는지는 서버가 맡습니다.

개발자용

우편함은 @idosgames/core의 client.mailbox로 작동합니다.

// 카테고리별 편지, 그다음 기다리는 모든 것을 한 번에 받기
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 스킬에 설명되어 있습니다.