GS2-Showcase API リファレンス

ゲーム内ストア機能を提供します。

販売する商品には対価と報酬を設定します。対価にも報酬にも複数のリソースを設定できます。

ステップガチャや、初回のみディスカウントといった仕組みを実現するために、商品グループという仕組みがあります。
商品グループは、商品ごとに優先度を付けて複数の商品をまとめる仕組みで、購入可能な条件を満たし、かつもっとも優先度の高い商品が陳列されます。

スタンダード陳列棚は指定した DisplayItem が全て陳列されます。
DisplayItem には2種類存在し《SalesItem》と《SalesItemGroup》が存在します。

• SalesItem には購入するために必要な対価と、購入した際に得られる報酬を設定できます。
• SalesItemGroup は購入回数に応じて販売する SalesItem が変化する仕組みを実現します。

ランダム陳列棚は、マスターデータに指定した DisplayItem のうち指定した数がランダムに抽選されて陳列されます。

抽選結果はプレイヤーごとに RandomShowcaseStatus として保存され、購入時には在庫が消費されます。再抽選間隔を迎えると次回アクセス時に陳列内容が更新されます。

GS2-Buff と連携すると DisplayItem および RandomDisplayItemModel の acquireActions・verifyActions・consumeActions を動的に補正でき、ランダム陳列商品では stock の上書きも可能です。イベントやキャンペーンに合わせて報酬や必要対価、在庫数を柔軟に変更できます。