GS2-Ranking2 マスターデータリファレンス

マスターデータのフォーマットと インポートする各種モデルのリファレンス

マスターデータのフォーマット

{
  "version": "2024-05-30",
  "globalRankingModels": [
    {
      "name": "[string]グローバルランキングモデル名",
      "metadata": "[string?]メタデータ",
      "minimumValue": "[long?]スコアの最小値",
      "maximumValue": "[long?]スコアの最大値",
      "sum": "[bool]スコア合算",
      "orderDirection": "[string (enum)]ソート方向",
      "entryPeriodEventId": "[string?]スコア登録可能期間イベントGRN",
      "rankingRewards": [
        {
          "thresholdRank": "[int]順位閾値",
          "metadata": "[string?]メタデータ",
          "acquireActions": [
            {
              "action": "[string]入手アクションで実行するアクションの種類",
              "request": "[string]アクション実行時に使用されるリクエストのJSON文字列"
            }
          ]
        }
      ],
      "accessPeriodEventId": "[string?]ランキングデータアクセス可能期間イベントGRN",
      "rewardCalculationIndex": "[string (enum)]報酬計算インデックス"
    }
  ],
  "clusterRankingModels": [
    {
      "name": "[string]クラスターランキングモデル名",
      "metadata": "[string?]メタデータ",
      "clusterType": "[string (enum)]クラスタータイプ",
      "minimumValue": "[long?]スコアの最小値",
      "maximumValue": "[long?]スコアの最大値",
      "sum": "[bool]スコア合算",
      "orderDirection": "[string (enum)]ソート方向",
      "entryPeriodEventId": "[string?]スコア登録可能期間イベントGRN",
      "rankingRewards": [
        {
          "thresholdRank": "[int]順位閾値",
          "metadata": "[string?]メタデータ",
          "acquireActions": [
            {
              "action": "[string]入手アクションで実行するアクションの種類",
              "request": "[string]アクション実行時に使用されるリクエストのJSON文字列"
            }
          ]
        }
      ],
      "accessPeriodEventId": "[string?]ランキングデータアクセス可能期間イベントGRN",
      "rewardCalculationIndex": "[string (enum)]報酬計算インデックス"
    }
  ],
  "subscribeRankingModels": [
    {
      "name": "[string]購読ランキングモデル名",
      "metadata": "[string?]メタデータ",
      "minimumValue": "[long?]スコアの最小値",
      "maximumValue": "[long?]スコアの最大値",
      "sum": "[bool]スコア合算",
      "orderDirection": "[string (enum)]ソート方向",
      "entryPeriodEventId": "[string?]スコア登録可能期間イベントGRN",
      "accessPeriodEventId": "[string?]ランキングデータアクセス可能期間イベントGRN"
    }
  ]
}
有効化条件 必須 デフォルト 値の制限 説明
version string
2024-05-30 マスターデータのフォーマットバージョン
globalRankingModels List<GlobalRankingModel> ~ 10 items グローバルランキングモデル
グローバルランキングは全てのプレイヤーを対象としたランキングを実現するためのモデルです。
上位1000位までのランキングを表示することができます。

GS2-Schedule の繰り返しイベントと関連づけると、繰り返し回数に応じてランキングをリセットすることができます。
clusterRankingModels List<ClusterRankingModel> ~ 10 items クラスターランキングモデル
クラスターランキングはギルドやギャザリング内のプレイヤーを対象としたランキングを実現するためのモデルです。
上位1000位までのランキングを表示することができます。

GS2-Schedule の繰り返しイベントと関連づけると、繰り返し回数に応じてランキングをリセットすることができます。
subscribeRankingModels List<SubscribeRankingModel> ~ 10 items 購読ランキングモデル
購読した他プレイヤーのスコアを集計し、ランキングを作成するモデルです。

モデル

GlobalRankingModel

グローバルランキングモデル

グローバルランキングは全てのプレイヤーを対象としたランキングを実現するためのモデルです。
上位1000位までのランキングを表示することができます。

GS2-Schedule の繰り返しイベントと関連づけると、繰り返し回数に応じてランキングをリセットすることができます。

有効化条件 必須 デフォルト 値の制限 説明
globalRankingModelId string
~ 1024文字 グローバルランキング GRN
※ サーバーが自動で設定
name string
~ 128文字 グローバルランキングモデル名
グローバルランキングモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadata string ~ 1024文字 メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
minimumValue long 0 ~ 9223372036854775805 スコアの最小値
許容されるスコアの最小値です。この値を下回るスコアは登録時に拒否されます。無効または意図しないスコア値のフィルタリングに使用します。
maximumValue long 0 ~ 9223372036854775805 スコアの最大値
許容されるスコアの最大値です。この値を超えるスコアは登録時に拒否されます。異常に高いスコアの登録防止に使用します。
sum bool false スコア合算
有効にすると、登録されたすべてのスコアが合算され、合計値でランキングが決定されます。無効の場合、ソート方向に応じた最良のスコア(最高値または最低値)のみがランキングに使用されます。
orderDirection 文字列列挙型
enum {
  “asc”,
  “desc”
}
ソート方向
ランキングスコアのソート方向です。低いスコアほど上位の場合(例:タイムアタック)は「昇順」、高いスコアほど上位の場合(例:ハイスコア)は「降順」を使用します。
定義説明
“asc”昇順
“desc”降順
entryPeriodEventId string ~ 1024文字 スコア登録可能期間イベント GRN
スコアを登録できる期間を定義する GS2-Schedule のイベントGRNです。繰り返しイベントと関連づけると、繰り返しサイクルごとにランキングがリセットされ、シーズン制ランキングを実現できます。
rankingRewards List<RankingReward> {entryPeriodEventId} != null [] 0 ~ 100 items ランキング報酬リスト
各シーズン終了時のランキング順位に基づいて付与される報酬のリストです。スコア登録可能期間イベントが設定されている場合のみ利用可能です。各報酬は順位閾値と実行する入手アクションを定義します。
accessPeriodEventId string ~ 1024文字 ランキングデータアクセス可能期間イベント GRN
ランキング結果の閲覧と報酬の受け取りが可能な期間を定義する GS2-Schedule のイベントGRNです。通常、スコア登録期間の間のインターバルに設定します。
rewardCalculationIndex 文字列列挙型
enum {
  “rank”,
  “index”
}
“rank” 報酬計算インデックス
報酬をプレイヤーに対応付ける方法を決定します。「順位ベース」は1始まりのランキング順位を使用し(同スコアのプレイヤーは同じ順位を共有)、「インデックスベース」は0始まりの一意のソート位置を使用します(同順位なし)。通常のユースケースでは「順位ベース」を選択してください。
定義説明
“rank”順位ベースで報酬を決定
“index”インデックスベースで報酬を決定

RankingReward

ランキング報酬

スコアの登録期間が設定されたランキングで、登録期間外で参照期間内の時に受け取れる報酬を設定します。
繰り返し設定が有効な場合、直近に期間を終えたランキングが報酬の受け取り対象となります。

有効化条件 必須 デフォルト 値の制限 説明
thresholdRank int
1 ~ 1001 順位閾値
この報酬ティアの順位閾値です。順位(またはインデックス、rewardCalculationIndex の設定に依存)がこの閾値以上のプレイヤーがこの報酬を受け取ります。1001に設定すると、ランク外(上位1000位外)のプレイヤー向けの報酬を定義できます。
metadata string ~ 1024文字 メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
acquireActions List<AcquireAction> [] 0 ~ 100 items 入手アクションリスト
プレイヤーがこのランキング報酬を受け取る際に実行される入手アクションのリストです。この順位閾値を達成した報酬として付与されるアイテム、通貨、その他のリソースを定義します。

AcquireAction

入手アクション

有効化条件 必須 デフォルト 値の制限 説明
action 文字列列挙型
enum {
"Gs2AdReward:AcquirePointByUserId",
"Gs2Dictionary:AddEntriesByUserId",
"Gs2Enchant:ReDrawBalanceParameterStatusByUserId",
"Gs2Enchant:SetBalanceParameterStatusByUserId",
"Gs2Enchant:ReDrawRarityParameterStatusByUserId",
"Gs2Enchant:AddRarityParameterStatusByUserId",
"Gs2Enchant:SetRarityParameterStatusByUserId",
"Gs2Enhance:DirectEnhanceByUserId",
"Gs2Enhance:UnleashByUserId",
"Gs2Enhance:CreateProgressByUserId",
"Gs2Exchange:ExchangeByUserId",
"Gs2Exchange:IncrementalExchangeByUserId",
"Gs2Exchange:CreateAwaitByUserId",
"Gs2Exchange:AcquireForceByUserId",
"Gs2Exchange:SkipByUserId",
"Gs2Experience:AddExperienceByUserId",
"Gs2Experience:SetExperienceByUserId",
"Gs2Experience:AddRankCapByUserId",
"Gs2Experience:SetRankCapByUserId",
"Gs2Experience:MultiplyAcquireActionsByUserId",
"Gs2Formation:AddMoldCapacityByUserId",
"Gs2Formation:SetMoldCapacityByUserId",
"Gs2Formation:AcquireActionsToFormProperties",
"Gs2Formation:SetFormByUserId",
"Gs2Formation:AcquireActionsToPropertyFormProperties",
"Gs2Friend:UpdateProfileByUserId",
"Gs2Grade:AddGradeByUserId",
"Gs2Grade:ApplyRankCapByUserId",
"Gs2Grade:MultiplyAcquireActionsByUserId",
"Gs2Guild:IncreaseMaximumCurrentMaximumMemberCountByGuildName",
"Gs2Guild:SetMaximumCurrentMaximumMemberCountByGuildName",
"Gs2Idle:IncreaseMaximumIdleMinutesByUserId",
"Gs2Idle:SetMaximumIdleMinutesByUserId",
"Gs2Idle:ReceiveByUserId",
"Gs2Inbox:SendMessageByUserId",
"Gs2Inventory:AddCapacityByUserId",
"Gs2Inventory:SetCapacityByUserId",
"Gs2Inventory:AcquireItemSetByUserId",
"Gs2Inventory:AcquireItemSetWithGradeByUserId",
"Gs2Inventory:AddReferenceOfByUserId",
"Gs2Inventory:DeleteReferenceOfByUserId",
"Gs2Inventory:AcquireSimpleItemsByUserId",
"Gs2Inventory:SetSimpleItemsByUserId",
"Gs2Inventory:AcquireBigItemByUserId",
"Gs2Inventory:SetBigItemByUserId",
"Gs2JobQueue:PushByUserId",
"Gs2Limit:CountDownByUserId",
"Gs2Limit:DeleteCounterByUserId",
"Gs2LoginReward:DeleteReceiveStatusByUserId",
"Gs2LoginReward:UnmarkReceivedByUserId",
"Gs2Lottery:DrawByUserId",
"Gs2Lottery:ResetBoxByUserId",
"Gs2Mission:RevertReceiveByUserId",
"Gs2Mission:IncreaseCounterByUserId",
"Gs2Mission:SetCounterByUserId",
"Gs2Money:DepositByUserId",
"Gs2Money:RevertRecordReceipt",
"Gs2Money2:DepositByUserId",
"Gs2Quest:CreateProgressByUserId",
"Gs2Schedule:TriggerByUserId",
"Gs2Schedule:ExtendTriggerByUserId",
"Gs2Script:InvokeScript",
"Gs2SerialKey:RevertUseByUserId",
"Gs2SerialKey:IssueOnce",
"Gs2Showcase:DecrementPurchaseCountByUserId",
"Gs2Showcase:ForceReDrawByUserId",
"Gs2SkillTree:MarkReleaseByUserId",
"Gs2Stamina:RecoverStaminaByUserId",
"Gs2Stamina:RaiseMaxValueByUserId",
"Gs2Stamina:SetMaxValueByUserId",
"Gs2Stamina:SetRecoverIntervalByUserId",
"Gs2Stamina:SetRecoverValueByUserId",
"Gs2StateMachine:StartStateMachineByUserId",
}
入手アクションで実行するアクションの種類
request string
~ 524288文字 アクション実行時に使用されるリクエストのJSON文字列

ClusterRankingModel

クラスターランキングモデル

クラスターランキングはギルドやギャザリング内のプレイヤーを対象としたランキングを実現するためのモデルです。
上位1000位までのランキングを表示することができます。

GS2-Schedule の繰り返しイベントと関連づけると、繰り返し回数に応じてランキングをリセットすることができます。

有効化条件 必須 デフォルト 値の制限 説明
clusterRankingModelId string
~ 1024文字 クラスターランキング GRN
※ サーバーが自動で設定
name string
~ 128文字 クラスターランキングモデル名
クラスターランキングモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadata string ~ 1024文字 メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
clusterType 文字列列挙型
enum {
  “Raw”,
  “Gs2Guild::Guild”,
  “Gs2Matchmaking::SeasonGathering”
}
クラスタータイプ
ランキングのセグメンテーションに使用するグループ(クラスター)の種類を定義します。「Raw」は所属検証なしで任意のクラスター名を指定でき、「Gs2Guild::Guild」はGS2-Guildギルドへの所属を検証し、「Gs2Matchmaking::SeasonGathering」はGS2-Matchmakingシーズンギャザリングへの所属を検証します。
定義説明
“Raw”検証なし
“Gs2Guild::Guild”GS2-Guild ギルド
“Gs2Matchmaking::SeasonGathering”GS2-Matchmaking シーズンギャザリング
minimumValue long 0 ~ 9223372036854775805 スコアの最小値
許容されるスコアの最小値です。この値を下回るスコアは登録時に拒否されます。
maximumValue long 0 ~ 9223372036854775805 スコアの最大値
許容されるスコアの最大値です。この値を超えるスコアは登録時に拒否されます。
sum bool false スコア合算
有効にすると、登録されたすべてのスコアが合算され、合計値でランキングが決定されます。無効の場合、最良のスコアのみがランキングに使用されます。
orderDirection 文字列列挙型
enum {
  “asc”,
  “desc”
}
ソート方向
ランキングスコアのソート方向です。低いスコアほど上位の場合は「昇順」、高いスコアほど上位の場合は「降順」を使用します。
定義説明
“asc”昇順
“desc”降順
entryPeriodEventId string ~ 1024文字 スコア登録可能期間イベント GRN
スコアを登録できる期間を定義する GS2-Schedule のイベントGRNです。繰り返しイベントと関連づけると、シーズン制ランキングを実現できます。
rankingRewards List<RankingReward> {entryPeriodEventId} != null [] 0 ~ 100 items ランキング報酬リスト
各シーズン終了時のランキング順位に基づいて付与される報酬のリストです。スコア登録可能期間イベントが設定されている場合のみ利用可能です。
accessPeriodEventId string ~ 1024文字 ランキングデータアクセス可能期間イベント GRN
ランキング結果の閲覧と報酬の受け取りが可能な期間を定義する GS2-Schedule のイベントGRNです。
rewardCalculationIndex 文字列列挙型
enum {
  “rank”,
  “index”
}
“rank” 報酬計算インデックス
報酬をプレイヤーに対応付ける方法を決定します。「順位ベース」は1始まりのランキング順位(同スコアは同順位)、「インデックスベース」は0始まりの一意のソート位置(同順位なし)を使用します。
定義説明
“rank”順位ベースで報酬を決定
“index”インデックスベースで報酬を決定

SubscribeRankingModel

購読ランキングモデル

購読した他プレイヤーのスコアを集計し、ランキングを作成するモデルです。

有効化条件 必須 デフォルト 値の制限 説明
subscribeRankingModelId string
~ 1024文字 購読ランキング GRN
※ サーバーが自動で設定
name string
~ 128文字 購読ランキングモデル名
購読ランキングモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadata string ~ 1024文字 メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
minimumValue long 0 ~ 9223372036854775805 スコアの最小値
許容されるスコアの最小値です。この値を下回るスコアは登録時に拒否されます。
maximumValue long 0 ~ 9223372036854775805 スコアの最大値
許容されるスコアの最大値です。この値を超えるスコアは登録時に拒否されます。
sum bool false スコア合算
有効にすると、登録されたすべてのスコアが合算され、合計値でランキングが決定されます。無効の場合、最良のスコアのみがランキングに使用されます。
orderDirection 文字列列挙型
enum {
  “asc”,
  “desc”
}
ソート方向
ランキングスコアのソート方向です。低いスコアほど上位の場合は「昇順」、高いスコアほど上位の場合は「降順」を使用します。
定義説明
“asc”昇順
“desc”降順
entryPeriodEventId string ~ 1024文字 スコア登録可能期間イベント GRN
スコアを登録できる期間を定義する GS2-Schedule のイベントGRNです。繰り返しイベントと関連づけると、シーズン制ランキングを実現できます。
accessPeriodEventId string ~ 1024文字 ランキングデータアクセス可能期間イベント GRN
ランキング結果の閲覧が可能な期間を定義する GS2-Schedule のイベントGRNです。