> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Showcase API 레퍼런스

상품 판매 기능




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

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

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

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

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

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

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

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

[마이크로서비스 소개 / GS2-Showcase](../../microservices/showcase)



- [GS2-Showcase Buff 레퍼런스](/ko/api_reference/showcase/buff/)
  
- [GS2-Showcase Deploy/CDK 레퍼런스](/ko/api_reference/showcase/deploy/)
  
- [GS2-Showcase SDK API 레퍼런스](/ko/api_reference/showcase/sdk/)
  
- [GS2-Showcase SDK for Game Engine API 레퍼런스](/ko/api_reference/showcase/game_engine/)
  
- [GS2-Showcase 마스터 데이터 레퍼런스](/ko/api_reference/showcase/master_data/)
  
- [GS2-Showcase 스크립트 트리거 레퍼런스](/ko/api_reference/showcase/script/)
  
- [GS2-Showcase 트랜잭션 액션](/ko/api_reference/showcase/stamp_sheet/)