게임 속 루트박스와 상자

플레이어가 보는 것

• 상자를 여는 방법마다 카드: 재화, 상자 아이템, 열쇠.
• 상자 한도와 잔액이 허락하면 "열기"와 "10개 열기".
• 여는 애니메이션: 서버가 결과를 정하는 동안 상자가 흔들리다 터지고 보상이 날아갑니다.
• 가진 아이템으로 열 수 있는 상자 수를 보여 주는 배지.

작동 방식

• 상자 내용과 확률은 대시보드에서 정하고, 열 때마다 서버가 결과를 정합니다.
• 인벤토리의 상자나 열쇠가 알맞은 상자가 선택된 이 화면을 엽니다.
• 방치형 RPG 템플릿은 루트박스를 장비 소환으로 씁니다.

개발자용

루트박스는 @idosgames/core의 client.lootbox로 작동합니다.

// 선택한 가격 옵션으로 상자를 열 번 열기
const res = await client.lootbox.open('gold_chest', 10, 'gems')
if (!res.ok) return showError(res.error)
// 나온 것은 SDK 캐시의 잔액과 인벤토리에 이미 반영되어 있습니다

• 결과를 클라이언트에서 정하지 마세요. 결과는 서버 응답에서만 옵니다.
• 요청이 진행되는 동안 버튼을 끄세요. 호출 하나하나가 별개의 열기입니다.

모든 필드는 SDK의 MCP 서버가 제공하는 lootbox-system 스킬에 설명되어 있습니다.