인벤토리: 플레이어의 아이템과 재화

플레이어가 보는 것

• 카테고리 탭: 장비, 소모품, 기타.
• 아이템마다 희귀도 테두리, 수량, 레벨.
• 설명이 있는 아이템 카드.
• 넘기기: 장비는 영웅 화면을, 상자나 열쇠는 상자를 엽니다.

작동 방식

• 인벤토리는 SDK 캐시를 읽으며 자체 요청을 보내지 않습니다.
• 겹치는 아이템은 수량으로, 고유 아이템(장비)은 자기 레벨이 있는 인스턴스로 보관됩니다.
• 아이템을 주거나 쓰는 모든 시스템이 서버의 같은 인벤토리를 바꿉니다.

개발자용

아이템과 재화는 @idosgames/core의 client.item과 client.currency로 작동하며, 상태는 SDK 캐시에 있습니다.

// 로그인 후 인벤토리는 이미 SDK 캐시에 있어 추가 요청이 필요 없습니다
const inv = client.data.user.state?.Inventory
inv?.VirtualCurrencies?.['GOLD'] // 재화 잔액
inv?.Items?.['potion']?.TotalAmount // 겹치는 아이템
Object.values(inv?.UnstackableItems ?? {}) // 레벨이 있는 장비 인스턴스

• 캐시로 그리세요. 구매, 보상, 제작 뒤에 알아서 업데이트됩니다.
• 아이템은 시스템(보상, 상점, 상자)으로만 주세요. 클라이언트는 절대 아이템을 추가하지 않습니다.

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