Documentation index for AI agents

GS2-Limit 마스터 데이터 레퍼런스

마스터 데이터 포맷과 임포트할 각종 모델의 레퍼런스

마스터 데이터 포맷

{
  "version": "2019-04-05",
  "limitModels": [
    {
      "name": "[string]횟수 제한 모델명",
      "metadata": "[string?]메타데이터",
      "resetType": "[문자열 열거형]리셋 타이밍",
      "resetDayOfMonth": "[int]리셋 날짜",
      "resetDayOfWeek": "[문자열 열거형]리셋 요일",
      "resetHour": "[int]리셋 시각",
      "anchorTimestamp": "[long]경과 일수를 계산하는 기준 일시",
      "days": "[int]리셋 일수"
    }
  ]
}
타입활성화 조건필수기본값값 제한설명
versionstring
2019-04-05마스터 데이터 포맷 버전
limitModelsList<LimitModel>~ 100 items횟수 제한 모델
횟수 제한 모델에는 사용 횟수를 리셋하는 타이밍을 설정할 수 있습니다.
리셋 간격은 “매일”, “매주”, “매월”, “리셋하지 않음”, “일정 일수마다” 5가지 중에서 선택할 수 있습니다.

또한, 횟수 제한의 최대값은 마스터 데이터 쪽에서는 고정하지 않습니다.
이는 게임 내 컨텍스트에 따라 허용되는 최대 횟수를 동적으로 변경할 수 있도록 하기 위함입니다.
예를 들어 스텝업 가챠처럼,
- 구매 횟수 카운터가 3회 미만일 때 구매할 수 있는 상품
- 위 상품을 구매할 수 없을 때, 구매 횟수 카운터가 5회 미만이면 구매할 수 있는 다른 상품

과 같이, 상황에 따라 “최대 횟수"를 전환할 수 있는 설계를 상정하고 있습니다.

모델

LimitModel

횟수 제한 모델

횟수 제한 모델에는 사용 횟수를 리셋하는 타이밍을 설정할 수 있습니다.
리셋 간격은 “매일”, “매주”, “매월”, “리셋하지 않음”, “일정 일수마다” 5가지 중에서 선택할 수 있습니다.

또한, 횟수 제한의 최대값은 마스터 데이터 쪽에서는 고정하지 않습니다.
이는 게임 내 컨텍스트에 따라 허용되는 최대 횟수를 동적으로 변경할 수 있도록 하기 위함입니다.
예를 들어 스텝업 가챠처럼,

  • 구매 횟수 카운터가 3회 미만일 때 구매할 수 있는 상품
  • 위 상품을 구매할 수 없을 때, 구매 횟수 카운터가 5회 미만이면 구매할 수 있는 다른 상품

과 같이, 상황에 따라 “최대 횟수"를 전환할 수 있는 설계를 상정하고 있습니다.

타입활성화 조건필수기본값값 제한설명
limitModelIdstring
~ 1024자횟수 제한 모델 GRN
※ 서버가 자동으로 설정
namestring
~ 128자횟수 제한 모델명
횟수 제한 모델 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다.
metadatastring~ 2048자메타데이터
메타데이터에는 임의의 값을 설정할 수 있습니다.
이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다.
resetType문자열 열거형
enum {
  “notReset”,
  “daily”,
  “weekly”,
  “monthly”,
  “days”
}
리셋 타이밍
이 횟수 제한 모델 하위의 카운터 값이 자동으로 0으로 리셋되는 타이밍을 결정합니다. notReset(영구적, 리셋 없음), daily(매일 지정된 시각에 리셋), weekly(지정된 요일에 리셋), monthly(지정된 날짜에 리셋), days(기준 일시로부터 일정 일수마다 리셋) 중에서 선택합니다. 모든 시각은 UTC입니다.
정의설명
notReset리셋 안 함
daily매일
weekly매주
monthly매월
days일정 일수마다
resetDayOfMonthint{resetType} == “monthly”
✓※
1 ~ 31리셋 날짜
resetType이 “monthly"인 경우 카운터가 리셋되는 날짜(일)입니다. 1~31 사이의 값이 유효합니다. 지정한 날짜가 해당 월의 일수를 초과하는 경우(예: 2월의 31일), 해당 월의 마지막 날에 리셋됩니다.
※ resetType이(가) “monthly” 이면 필수
resetDayOfWeek문자열 열거형
enum {
  “sunday”,
  “monday”,
  “tuesday”,
  “wednesday”,
  “thursday”,
  “friday”,
  “saturday”
}
{resetType} == “weekly”
✓※
리셋 요일
resetType이 “weekly"인 경우 카운터가 리셋되는 요일입니다. 이 요일의 resetHour(UTC)로 지정된 시각에 리셋됩니다.
정의설명
sunday일요일
monday월요일
tuesday화요일
wednesday수요일
thursday목요일
friday금요일
saturday토요일
※ resetType이(가) “weekly” 이면 필수
resetHourint{resetType} in [“monthly”, “weekly”, “daily”]
✓※
0 ~ 23리셋 시각
daily, weekly, monthly 리셋 타입에서 카운터가 리셋되는 UTC 시각(0~23)입니다. 예를 들어 값이 0이면 UTC 자정에 카운터가 리셋됩니다.
※ resetType이(가) “monthly”,“weekly”,“daily"이면 필수
anchorTimestamplong{resetType} == “days”
✓※
경과 일수를 계산하는 기준 일시
UNIX 시간(밀리초)
※ resetType이(가) “days” 이면 필수
daysint{resetType} == “days”
✓※
1 ~ 2147483646리셋 일수
resetType이 “days"인 경우 카운터 리셋 간격(일수)입니다. 리셋 주기는 anchorTimestamp를 기준으로 계산됩니다. 예를 들어 days가 7이고 anchorTimestamp가 월요일 정오라면, 매주 월요일 정오에 카운터가 리셋됩니다.
※ resetType이(가) “days” 이면 필수