GS2-Matchmaking 마스터 데이터 레퍼런스
마스터 데이터 포맷과 임포트할 각종 모델의 레퍼런스
마스터 데이터 포맷
{
"version": "2020-06-24",
"ratingModels": [
{
"name": "[string]레이팅 모델 이름",
"metadata": "[string?]메타데이터",
"initialValue": "[int]레이트 값의 초기값",
"volatility": "[int]레이팅의 변동성"
}
],
"seasonModels": [
{
"name": "[string]시즌 모델 이름",
"metadata": "[string?]메타데이터",
"maximumParticipants": "[int]최대 참가 인원수",
"experienceModelId": "[string?]티어 관리용 경험치 모델 GRN",
"challengePeriodEventId": "[string]챌린지 기간 이벤트 GRN"
}
]
}| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| version | string | ✓ | 2020-06-24 | 마스터 데이터 포맷 버전 | ||
| ratingModels | List<RatingModel> | ~ 50 items | 레이팅 모델 GS2에서는 레이팅 알고리즘으로 Glicko-2를 채택하고 있습니다. Glicko-2에는 여러 파라미터가 있지만, GS2-Matchmaking에서는 이를 종합적으로 나타내는 변동성이라는 하나의 파라미터로 통합하고 있습니다. 변동성은 변화의 크기를 나타내는 파라미터로, 값이 클수록 레이팅 값의 변동 폭이 커집니다. | |||
| seasonModels | List<SeasonModel> | ~ 50 items | 시즌 모델 시즌 매치메이킹에서, 일정 기간 동안 유효한 영속 개더링의 기간·최대 참가 인원수·티어 연동 설정을 정의하는 마스터 데이터입니다. GS2-Schedule을 통해 기간을 관리하며, 필요에 따라 GS2-Experience와 연동하여 동일한 티어 내에서 영속 개더링을 형성합니다. |
모델
RatingModel
레이팅 모델
GS2에서는 레이팅 알고리즘으로 Glicko-2를 채택하고 있습니다.
Glicko-2에는 여러 파라미터가 있지만, GS2-Matchmaking에서는 이를 종합적으로 나타내는 변동성이라는 하나의 파라미터로 통합하고 있습니다.
변동성은 변화의 크기를 나타내는 파라미터로, 값이 클수록 레이팅 값의 변동 폭이 커집니다.
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| ratingModelId | string | ※ | ~ 1024자 | 레이팅 모델
GRN
※ 서버가 자동으로 설정 | ||
| name | string | ✓ | ~ 128자 | 레이팅 모델 이름 레이팅 모델 고유의 이름. 영숫자 및 -(하이픈), _(밑줄), .(마침표)로 지정합니다. | ||
| metadata | string | ~ 128자 | 메타데이터 메타데이터에는 임의의 값을 설정할 수 있습니다. 이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다. | |||
| initialValue | int | 1500 | 100 ~ 10000 | 레이트 값의 초기값 플레이어가 처음 레이팅이 적용된 매치메이킹에 참가할 때 부여되는 시작 레이트 값입니다. 기본값은 1500입니다. 모든 플레이어는 동일한 레이팅에서 시작하며, 대전 결과에 따라 조정됩니다. | ||
| volatility | int | 100 | 1 ~ 20000 | 레이팅의 변동성 각 대전 후 레이트 값이 얼마나 변동하는지를 제어하는 Glicko-2의 파라미터입니다. 값이 클수록 레이팅의 변동 폭이 커져 더 빠르게 레이팅이 조정됩니다. 값이 작을수록 레이팅이 안정되어 완만하게 변화합니다. 기본값은 100입니다. |
SeasonModel
시즌 모델
시즌 매치메이킹에서, 일정 기간 동안 유효한 영속 개더링의 기간·최대 참가 인원수·티어 연동 설정을 정의하는 마스터 데이터입니다.
GS2-Schedule을 통해 기간을 관리하며, 필요에 따라 GS2-Experience와 연동하여 동일한 티어 내에서 영속 개더링을 형성합니다.
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| seasonModelId | string | ※ | ~ 1024자 | 시즌 모델
GRN
※ 서버가 자동으로 설정 | ||
| name | string | ✓ | ~ 128자 | 시즌 모델 이름 시즌 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| metadata | string | ~ 128자 | 메타데이터 메타데이터에는 임의의 값을 설정할 수 있습니다. 이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다. | |||
| maximumParticipants | int | ✓ | 2 ~ 1000 | 최대 참가 인원수 하나의 시즌 개더링에 참가할 수 있는 플레이어의 최대 인원수입니다. 이 상한에 도달하면 시즌 개더링은 만원 상태가 되어 더 이상 플레이어가 참가할 수 없게 됩니다. 2에서 1000 사이의 범위로 지정합니다. | ||
| experienceModelId | string | ~ 1024자 | 티어 관리용 경험치 모델 GRN
플레이어의 티어를 결정하기 위해 사용하는 GS2-Experience 경험치 모델의 GRN입니다. 이 경험치 모델에서의 플레이어 랭크가 매치메이킹의 티어로 사용되어, 비슷한 레벨의 플레이어끼리 그룹화됩니다. 지정하지 않으면 티어에 의한 그룹화가 비활성화되어, 레벨에 관계없이 모든 플레이어가 매칭됩니다. | |||
| challengePeriodEventId | string | ✓ | ~ 1024자 | 챌린지 기간 이벤트 GRN
이 시즌의 유효 기간을 정의하는 GS2-Schedule 이벤트의 GRN입니다. 이 이벤트가 활성화되어 있는 동안에만 시즌 개더링의 생성·참가가 가능합니다. 이벤트 기간이 종료되면 시즌이 종료되어 새로운 매치메이킹이 불가능해집니다. |