GS2-Limit API リファレンス

回数制限処理を実現するためのサービス

このサービスは単独で使うのではなく 他のサービスで回数制限機能を実現します。

カウンターは、プレイヤーの行動回数を表現するためのエンティティで、
カウンターの値を上昇する際に許容可能な最大値を指定してカウントアップを試みることで最大値を超える場合はカウントアップが失敗し、後続の処理を失敗させることができるメカニズムで回数制限を実現します。
このとき、カウンターに対して最大値が存在するのではなく、カウントアップアクションに最大値が設定できるのが特徴です。

たとえば、スタミナの回復処理を例に考えてみます。
多くのゲームでは1日にスタミナを回復できる回数には上限が設けられています。
そして、回復をすればするほど、回復に必要な金額が上昇していきます。

anchorTimestamp を活用すると、イベント開始日からN日ごとのリセットといった柔軟なスケジューリングが可能です。

GS2-Buff と連携すると、CountUp/CountUpByUserId の maxValue をバフで補正して一時的に上限値を増減できます。
「期間限定で1日に引けるガチャ回数を倍にする」といった、イベントに合わせた緩和措置を実装する際に有用です。