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

{
  "version": "2024-02-23",
  "seasonModels": [
    {
      "name": "[string]シーズンモデル名",
      "metadata": "[string?]メタデータ",
      "tiers": [
        {
          "metadata": "[string?]メタデータ",
          "raiseRankBonus": "[int]ランク昇格時にすぐにランク降格を防ぐために加算するボーナスポイント",
          "entryFee": "[int]ゲームを開始するための参加料として減算するポイント",
          "minimumChangePoint": "[int]負けた際に変動するレート値の最小値",
          "maximumChangePoint": "[int]勝った際に変動するレート値の最大値"
        }
      ],
      "experienceModelId": "[string]経験値モデルGRN",
      "challengePeriodEventId": "[string?]シーズンの期間を設定した GS2-Schedule イベントGRN"
    }
  ]
}
有効化条件必須デフォルト値の制限説明
version2024-02-23マスターデータのフォーマットバージョン
seasonModelsList<SeasonModel>~ 50 itemsシーズンモデル

SeasonModel

シーズンモデル

GS2 ではレーティングアルゴリズムとして Glicko-2 を採用しています。
Glicko-2 には複数のパラメータがありますが、GS2-Matchmaking ではそれらを総合的に表す ボラティリティ という1つのパラメータに集約しています。
ボラティリティ は変化の大きさを表すパラメータで、値が大きいほどレーティングの値の変動量が大きくなります。

有効化条件必須デフォルト値の制限説明
seasonModelIdstring~ 1024文字シーズンモデルGRN
namestring~ 128文字シーズンモデル名
metadatastring~ 128文字メタデータ
tiersList<TierModel>1 ~ 100 itemsティアーリスト
experienceModelIdstring~ 1024文字経験値モデルGRN
challengePeriodEventIdstring~ 1024文字シーズンの期間を設定した GS2-Schedule イベントGRN

TierModel

ティアーモデル

有効化条件必須デフォルト値の制限説明
metadatastring~ 128文字メタデータ
raiseRankBonusint~ 10000ランク昇格時にすぐにランク降格を防ぐために加算するボーナスポイント
entryFeeint~ 10000ゲームを開始するための参加料として減算するポイント
minimumChangePointint~ -1負けた際に変動するレート値の最小値
maximumChangePointint1 ~ 99999999勝った際に変動するレート値の最大値

VerifyActionResult

検証アクションの実行結果

有効化条件必須デフォルト値の制限説明
actionenum {
}
~ 128文字検証アクションで実行するアクションの種類
verifyRequeststring~ 1048576文字リクエストのJSON
statusCodeint~ 999ステータスコード
verifyResultstring~ 1048576文字結果内容

action に指定する列挙型の定義

定義説明

ConsumeActionResult

消費アクションの実行結果

有効化条件必須デフォルト値の制限説明
actionenum {
}
~ 128文字消費アクションで実行するアクションの種類
consumeRequeststring~ 1048576文字リクエストのJSON
statusCodeint~ 999ステータスコード
consumeResultstring~ 1048576文字結果内容

action に指定する列挙型の定義

定義説明

AcquireActionResult

入手アクションの実行結果

有効化条件必須デフォルト値の制限説明
actionenum {
}
~ 128文字入手アクションで実行するアクションの種類
acquireRequeststring~ 1048576文字リクエストのJSON
statusCodeint~ 999ステータスコード
acquireResultstring~ 1048576文字結果内容

action に指定する列挙型の定義

定義説明

TransactionResult

トランザクション実行結果

サーバーサイドでのトランザクションの自動実行機能を利用して実行されたトランザクションの実行結果

有効化条件必須デフォルト値の制限説明
transactionIdstring36 ~ 36文字トランザクションID
verifyResultsList<VerifyActionResult>~ 10 items検証アクションの実行結果リスト
consumeResultsList<ConsumeActionResult>~ 10 items消費アクションの実行結果リスト
acquireResultsList<AcquireActionResult>~ 100 items入手アクションの実行結果リスト

GameResult

対戦結果

有効化条件必須デフォルト値の制限説明
rankint~ 2147483646順位
userIdstring~ 128文字ユーザーID

Ballot

投票用紙

有効化条件必須デフォルト値の制限説明
userIdstring~ 128文字ユーザーID
seasonNamestring~ 128文字レーティング計算に使用するシーズン名
sessionNamestring~ 128文字投票対象のセッション名
numberOfPlayerint2 ~ 10参加人数

SignedBallot

署名付の投票用紙

有効化条件必須デフォルト値の制限説明
bodystring~ 1024文字投票用紙の署名対象のデータ
signaturestring~ 256文字投票用紙の署名

WrittenBallot

投票用紙

有効化条件必須デフォルト値の制限説明
ballotBallot投票用紙
gameResultsList<GameResult>~ 10 items投票内容。対戦結果のリスト