GS2-Matchmaking マスターデータリファレンス
{
"version": "2020-06-24",
"ratingModels": [
{
"name": "[string]レーティングモデル名",
"metadata": "[string?]メタデータ",
"initialValue": "[int]レート値の初期値",
"volatility": "[int]レート値の変動の大きさ"
}
]
}
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
version | ✓ | | 2020-06-24 | マスターデータのフォーマットバージョン | | |
ratingModels | List<RatingModel> | | | | | |
RatingModel
レーティングモデル
GS2 ではレーティングアルゴリズムとして Glicko-2 を採用しています。
Glicko-2 には複数のパラメータがありますが、GS2-Matchmaking ではそれらを総合的に表す ボラティリティ という1つのパラメータに集約しています。
ボラティリティ は変化の大きさを表すパラメータで、値が大きいほどレーティングの値の変動量が大きくなります。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
ratingModelId | string | | ✓ | | ~ 1024文字 | レーティングモデルGRN |
name | string | | ✓ | | ~ 128文字 | レーティングモデル名 |
metadata | string | | | | ~ 128文字 | メタデータ |
initialValue | int | | ✓ | 1500 | 100 ~ 10000 | レート値の初期値 |
volatility | int | | ✓ | 100 | 1 ~ 20000 | レート値の変動の大きさ |
AttributeRange
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
name | string | | ✓ | | ~ 128文字 | 属性名 |
min | int | | ✓ | 0 | ~ 2147483646 | ギャザリング参加可能な属性値の最小値 |
max | int | | ✓ | 0 | ~ 2147483646 | ギャザリング参加可能な属性値の最大値 |
CapacityOfRole
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
roleName | string | | ✓ | “default” | ~ 128文字 | ロール名 |
roleAliases | List<string> | | | [] | | ロール名の別名リスト |
capacity | int | | ✓ | | 1 ~ 256 | 募集人数 |
participants | List<Player> | | | [] | | 参加者のプレイヤー情報リスト |
Attribute
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
name | string | | ✓ | | ~ 128文字 | 属性名 |
value | int | | ✓ | 0 | ~ 2147483646 | 属性値 |
Player
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
userId | string | | ✓ | | ~ 128文字 | ユーザーID |
attributes | List<Attribute> | | | [] | | 属性値のリスト |
roleName | string | | ✓ | “default” | ~ 128文字 | ロール名 |
denyUserIds | List<string> | | | [] | | 参加を拒否するユーザIDリスト |
GameResult
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
rank | int | | ✓ | | ~ 2147483646 | 順位 |
userId | string | | ✓ | | ~ 128文字 | ユーザーID |
Ballot
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
userId | string | | ✓ | | ~ 128文字 | ユーザーID |
ratingName | string | | ✓ | | ~ 128文字 | レーティング計算に使用するレーティング名 |
gatheringName | string | | ✓ | | ~ 128文字 | 投票対象のギャザリング名 |
numberOfPlayer | int | | ✓ | | 2 ~ 10 | 参加人数 |
SignedBallot
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
body | string | | ✓ | | ~ 1024文字 | 投票用紙の署名対象のデータ |
signature | string | | ✓ | | ~ 256文字 | 投票用紙の署名 |
WrittenBallot
TimeSpan
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
days | int | | ✓ | 0 | ~ 365 | 現在時刻からの日数 |
hours | int | | ✓ | 0 | ~ 24 | 現在時刻からの時間 |
minutes | int | | ✓ | 0 | ~ 60 | 現在時刻からの分 |