GS2-Showcase API 레퍼런스

게임 내 상점 기능을 제공합니다.

판매하는 상품에는 대가와 보상을 설정합니다. 대가와 보상 모두에 여러 리소스를 설정할 수 있습니다.

스텝 가챠나 최초 1회 한정 할인과 같은 구조를 구현하기 위해 상품 그룹이라는 구조가 있습니다.
상품 그룹은 상품마다 우선순위를 부여하여 여러 상품을 하나로 묶는 구조로, 구매 가능한 조건을 만족하면서 가장 우선순위가 높은 상품이 진열됩니다.

스탠다드 진열대는 지정한 DisplayItem이 모두 진열됩니다.
DisplayItem에는 2종류가 있으며 《SalesItem》과 《SalesItemGroup》이 있습니다.

• SalesItem에는 구매하기 위해 필요한 대가와, 구매했을 때 얻을 수 있는 보상을 설정할 수 있습니다.
• SalesItemGroup은 구매 횟수에 따라 판매되는 SalesItem이 변화하는 구조를 구현합니다.

랜덤 진열대는 마스터 데이터에 지정한 DisplayItem 중 지정한 개수가 랜덤으로 추첨되어 진열됩니다.

추첨 결과는 플레이어별로 RandomShowcaseStatus로 저장되며, 구매 시에는 재고가 소비됩니다. 재추첨 간격이 도래하면 다음 접근 시에 진열 내용이 갱신됩니다.

GS2-Buff와 연동하면 DisplayItem 및 RandomDisplayItemModel의 acquireActions·verifyActions·consumeActions를 동적으로 보정할 수 있으며, 랜덤 진열 상품에서는 stock의 덮어쓰기도 가능합니다. 이벤트나 캠페인에 맞춰 보상이나 필요 대가, 재고 수를 유연하게 변경할 수 있습니다.