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"
}
]
}
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| version | ✓ | 2024-02-23 | マスターデータのフォーマットバージョン | |||
| seasonModels | List<SeasonModel> | ~ 50 items | シーズンモデル |
SeasonModel
シーズンモデル
GS2 ではレーティングアルゴリズムとして Glicko-2 を採用しています。
Glicko-2 には複数のパラメータがありますが、GS2-Matchmaking ではそれらを総合的に表す ボラティリティ という1つのパラメータに集約しています。
ボラティリティ は変化の大きさを表すパラメータで、値が大きいほどレーティングの値の変動量が大きくなります。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| seasonModelId | string | ✓ | ~ 1024文字 | シーズンモデルGRN | ||
| name | string | ✓ | ~ 128文字 | シーズンモデル名 | ||
| metadata | string | ~ 128文字 | メタデータ | |||
| tiers | List<TierModel> | ✓ | 1 ~ 100 items | ティアーリスト | ||
| experienceModelId | string | ✓ | ~ 1024文字 | 経験値モデルGRN | ||
| challengePeriodEventId | string | ~ 1024文字 | シーズンの期間を設定した GS2-Schedule イベントGRN |
TierModel
ティアーモデル
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| metadata | string | ~ 128文字 | メタデータ | |||
| raiseRankBonus | int | ✓ | 0 ~ 10000 | ランク昇格時にすぐにランク降格を防ぐために加算するボーナスポイント | ||
| entryFee | int | ✓ | 0 ~ 10000 | ゲームを開始するための参加料として減算するポイント | ||
| minimumChangePoint | int | ✓ | -99999999 ~ -1 | 負けた際に変動するレート値の最小値 | ||
| maximumChangePoint | int | ✓ | 1 ~ 99999999 | 勝った際に変動するレート値の最大値 |
VerifyActionResult
検証アクションの実行結果
ConsumeActionResult
消費アクションの実行結果
AcquireActionResult
入手アクションの実行結果
TransactionResult
トランザクション実行結果
サーバーサイドでのトランザクションの自動実行機能を利用して実行されたトランザクションの実行結果
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| transactionId | string | ✓ | 36 ~ 36文字 | トランザクションID | ||
| verifyResults | List<VerifyActionResult> | 0 ~ 10 items | 検証アクションの実行結果リスト | |||
| consumeResults | List<ConsumeActionResult> | [] | 0 ~ 10 items | 消費アクションの実行結果リスト | ||
| acquireResults | List<AcquireActionResult> | [] | 0 ~ 100 items | 入手アクションの実行結果リスト | ||
| hasError | bool | ✓ | false | トランザクション実行中にエラーが発生したかどうか |
GameResult
対戦結果
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| rank | int | ✓ | 0 ~ 2147483646 | 順位 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID |
Ballot
投票用紙
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| userId | string | ✓ | ~ 128文字 | ユーザーID | ||
| seasonName | string | ✓ | ~ 128文字 | レーティング計算に使用するシーズン名 | ||
| sessionName | string | ✓ | ~ 128文字 | 投票対象のセッション名 | ||
| numberOfPlayer | int | ✓ | 2 ~ 10 | 参加人数 |
SignedBallot
署名付の投票用紙
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| body | string | ✓ | ~ 1024文字 | 投票用紙の署名対象のデータ | ||
| signature | string | ✓ | ~ 256文字 | 投票用紙の署名 |
WrittenBallot
投票用紙
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| ballot | Ballot | ✓ | 投票用紙 | |||
| gameResults | List<GameResult> | 0 ~ 10 items | 投票内容。対戦結果のリスト |