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"
    }
  ]
}
有効化条件必須デフォルト値の制限説明
versionstring
2024-05-30マスターデータのフォーマットバージョン
globalRankingModelsList<GlobalRankingModel>~ 10 itemsグローバルランキングモデル
グローバルランキングは全てのプレイヤーを対象としたランキングを実現するためのモデルです。
上位1000位までのランキングを表示することができます。

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

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

モデル

GlobalRankingModel

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

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

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

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

RankingReward

ランキング報酬

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

有効化条件必須デフォルト値の制限説明
thresholdRankint
1 ~ 1001順位閾値
この報酬ティアの順位閾値です。順位(またはインデックス、rewardCalculationIndex の設定に依存)がこの閾値以上のプレイヤーがこの報酬を受け取ります。1001に設定すると、ランク外(上位1000位外)のプレイヤー向けの報酬を定義できます。
metadatastring~ 1024文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
acquireActionsList<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",
}
入手アクションで実行するアクションの種類
requeststring
~ 524288文字アクション実行時に使用されるリクエストのJSON文字列

ClusterRankingModel

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

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

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

有効化条件必須デフォルト値の制限説明
clusterRankingModelIdstring
~ 1024文字クラスターランキング GRN
※ サーバーが自動で設定
namestring
~ 128文字クラスターランキングモデル名
クラスターランキングモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadatastring~ 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 シーズンギャザリング
minimumValuelong0 ~ 9223372036854775805スコアの最小値
許容されるスコアの最小値です。この値を下回るスコアは登録時に拒否されます。
maximumValuelong0 ~ 9223372036854775805スコアの最大値
許容されるスコアの最大値です。この値を超えるスコアは登録時に拒否されます。
sumboolfalseスコア合算
有効にすると、登録されたすべてのスコアが合算され、合計値でランキングが決定されます。無効の場合、最良のスコアのみがランキングに使用されます。
orderDirection文字列列挙型
enum {
  “asc”,
  “desc”
}
ソート方向
ランキングスコアのソート方向です。低いスコアほど上位の場合は「昇順」、高いスコアほど上位の場合は「降順」を使用します。
定義説明
“asc”昇順
“desc”降順
entryPeriodEventIdstring~ 1024文字スコア登録可能期間イベント GRN
スコアを登録できる期間を定義する GS2-Schedule のイベントGRNです。繰り返しイベントと関連づけると、シーズン制ランキングを実現できます。
rankingRewardsList<RankingReward>{entryPeriodEventId} != null[]0 ~ 100 itemsランキング報酬リスト
各シーズン終了時のランキング順位に基づいて付与される報酬のリストです。スコア登録可能期間イベントが設定されている場合のみ利用可能です。
accessPeriodEventIdstring~ 1024文字ランキングデータアクセス可能期間イベント GRN
ランキング結果の閲覧と報酬の受け取りが可能な期間を定義する GS2-Schedule のイベントGRNです。
rewardCalculationIndex文字列列挙型
enum {
  “rank”,
  “index”
}
“rank”報酬計算インデックス
報酬をプレイヤーに対応付ける方法を決定します。「順位ベース」は1始まりのランキング順位(同スコアは同順位)、「インデックスベース」は0始まりの一意のソート位置(同順位なし)を使用します。
定義説明
“rank”順位ベースで報酬を決定
“index”インデックスベースで報酬を決定

SubscribeRankingModel

購読ランキングモデル

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

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