Documentation index for AI agents

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"
    }
  ]
}
타입활성화 조건필수기본값값 제한설명
versionstring
2020-06-24마스터 데이터 포맷 버전
ratingModelsList<RatingModel>~ 50 items레이팅 모델
GS2에서는 레이팅 알고리즘으로 Glicko-2를 채택하고 있습니다.
Glicko-2에는 여러 파라미터가 있지만, GS2-Matchmaking에서는 이를 종합적으로 나타내는 변동성이라는 하나의 파라미터로 통합하고 있습니다.
변동성은 변화의 크기를 나타내는 파라미터로, 값이 클수록 레이팅 값의 변동 폭이 커집니다.
seasonModelsList<SeasonModel>~ 50 items시즌 모델
시즌 매치메이킹에서, 일정 기간 동안 유효한 영속 개더링의 기간·최대 참가 인원수·티어 연동 설정을 정의하는 마스터 데이터입니다.
GS2-Schedule을 통해 기간을 관리하며, 필요에 따라 GS2-Experience와 연동하여 동일한 티어 내에서 영속 개더링을 형성합니다.

모델

RatingModel

레이팅 모델

GS2에서는 레이팅 알고리즘으로 Glicko-2를 채택하고 있습니다.
Glicko-2에는 여러 파라미터가 있지만, GS2-Matchmaking에서는 이를 종합적으로 나타내는 변동성이라는 하나의 파라미터로 통합하고 있습니다.
변동성은 변화의 크기를 나타내는 파라미터로, 값이 클수록 레이팅 값의 변동 폭이 커집니다.

타입활성화 조건필수기본값값 제한설명
ratingModelIdstring
~ 1024자레이팅 모델 GRN
※ 서버가 자동으로 설정
namestring
~ 128자레이팅 모델 이름
레이팅 모델 고유의 이름. 영숫자 및 -(하이픈), _(밑줄), .(마침표)로 지정합니다.
metadatastring~ 128자메타데이터
메타데이터에는 임의의 값을 설정할 수 있습니다.
이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다.
initialValueint1500100 ~ 10000레이트 값의 초기값
플레이어가 처음 레이팅이 적용된 매치메이킹에 참가할 때 부여되는 시작 레이트 값입니다.
기본값은 1500입니다. 모든 플레이어는 동일한 레이팅에서 시작하며, 대전 결과에 따라 조정됩니다.
volatilityint1001 ~ 20000레이팅의 변동성
각 대전 후 레이트 값이 얼마나 변동하는지를 제어하는 Glicko-2의 파라미터입니다.
값이 클수록 레이팅의 변동 폭이 커져 더 빠르게 레이팅이 조정됩니다.
값이 작을수록 레이팅이 안정되어 완만하게 변화합니다. 기본값은 100입니다.

SeasonModel

시즌 모델

시즌 매치메이킹에서, 일정 기간 동안 유효한 영속 개더링의 기간·최대 참가 인원수·티어 연동 설정을 정의하는 마스터 데이터입니다.
GS2-Schedule을 통해 기간을 관리하며, 필요에 따라 GS2-Experience와 연동하여 동일한 티어 내에서 영속 개더링을 형성합니다.

타입활성화 조건필수기본값값 제한설명
seasonModelIdstring
~ 1024자시즌 모델 GRN
※ 서버가 자동으로 설정
namestring
~ 128자시즌 모델 이름
시즌 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
metadatastring~ 128자메타데이터
메타데이터에는 임의의 값을 설정할 수 있습니다.
이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다.
maximumParticipantsint
2 ~ 1000최대 참가 인원수
하나의 시즌 개더링에 참가할 수 있는 플레이어의 최대 인원수입니다.
이 상한에 도달하면 시즌 개더링은 만원 상태가 되어 더 이상 플레이어가 참가할 수 없게 됩니다.
2에서 1000 사이의 범위로 지정합니다.
experienceModelIdstring~ 1024자티어 관리용 경험치 모델 GRN
플레이어의 티어를 결정하기 위해 사용하는 GS2-Experience 경험치 모델의 GRN입니다.
이 경험치 모델에서의 플레이어 랭크가 매치메이킹의 티어로 사용되어, 비슷한 레벨의 플레이어끼리 그룹화됩니다.
지정하지 않으면 티어에 의한 그룹화가 비활성화되어, 레벨에 관계없이 모든 플레이어가 매칭됩니다.
challengePeriodEventIdstring
~ 1024자챌린지 기간 이벤트 GRN
이 시즌의 유효 기간을 정의하는 GS2-Schedule 이벤트의 GRN입니다.
이 이벤트가 활성화되어 있는 동안에만 시즌 개더링의 생성·참가가 가능합니다.
이벤트 기간이 종료되면 시즌이 종료되어 새로운 매치메이킹이 불가능해집니다.