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

마스터 데이터 포맷

• JSON

{
  "version": "2023-07-11",
  "bonusModels": [
    {
      "name": "[string]로그인 보너스 모델명",
      "metadata": "[string?]메타데이터",
      "mode": "[문자열 열거형]모드",
      "periodEventId": "[string?]기간 이벤트 GRN",
      "resetHour": "[int]리셋 시간(UTC)",
      "repeat": "[문자열 열거형]반복",
      "rewards": [
        {
          "acquireActions": [
            {
              "action": "[string]입수 액션에서 실행할 액션의 종류",
              "request": "[string]액션 실행 시 사용되는 요청의 JSON 문자열"
            }
          ]
        }
      ],
      "missedReceiveRelief": "[문자열 열거형]미수령 구제 기능",
      "missedReceiveReliefVerifyActions": [
        {
          "action": "[string]검증 액션에서 실행할 액션의 종류",
          "request": "[string]액션 실행 시 사용되는 요청의 JSON 문자열"
        }
      ],
      "missedReceiveReliefConsumeActions": [
        {
          "action": "[string]소비 액션에서 실행할 액션의 종류",
          "request": "[string]액션 실행 시 사용되는 요청의 JSON 문자열"
        }
      ]
    }
  ]
}

모델

BonusModel

로그인 보너스 모델

로그인 보너스 모델에는 로그인 보너스의 배포 스케줄을 설정합니다.
배포 스케줄에는 《스케줄 모드》와 《스트리밍 모드》가 있습니다.

스케줄 모드에서는 GS2-Schedule의 이벤트 지정이 필수이며, 해당 이벤트의 시작일로부터 경과한 일수에 따라 보너스를 배포합니다.
도중에 놓친 날짜가 발생한 경우, 그 날의 보너스는 배포되지 않습니다.

스트리밍 모드에서는 매일 보너스에 설정된 보상을 처음부터 순서대로 배포합니다.
스트리밍 모드에서는 반복 설정이 가능합니다. 이 경우 스트림의 끝에 도달하면 다시 처음부터 배포를 시작합니다.

스케줄 모드·스트리밍 모드 모두 미수령 구제 기능이 있습니다.
일정한 비용을 지불함으로써 놓친 보너스를 수령할 수 있습니다.
단, GS2-Schedule의 이벤트가 연결되어 있는 경우, 이벤트 시작일로부터 경과한 일수보다 앞선 보너스는 받을 수 없습니다.
미수령 구제 기능은 스트리밍 모드이면서 반복이 활성화된 경우에는 사용할 수 없습니다.

스케줄 모드·스트리밍 모드 모두, 설정 가능한 보너스의 최대 일수는 100일입니다.

Reward

보상

로그인 보너스의 하루치 보상 설정을 나타냅니다.
각 Reward에는 사용자가 수신할 항목(아이템, 화폐, 경험치 등)을 정의하는 입수 액션 목록이 포함됩니다.
BonusModel의 rewards 배열은 하루당 하나의 Reward를 보유하며, 순서대로 배포됩니다.
보상 값은 버프 시스템(BonusModelBuff)을 통해 실행 시점에 변경할 수 있으며, 입수 액션에 배율을 적용할 수 있습니다.

ConsumeAction

소비 액션

소비 액션의 구조를 통해 사용자로부터 리소스를 소비하는 액션을 정의합니다.
미수령 보너스 구제에서 사용자가 지불해야 하는 비용(화폐 차감, 아이템 소비 등)을 지정하는 데 사용됩니다.
action 필드는 소비 액션의 종류를 지정하고, request 필드에는 그에 대응하는 요청 매개변수가 포함됩니다.

VerifyAction

검증 액션

작업을 실행하기 전에 조건을 검증하는 액션을 정의합니다.
미수령 보너스 구제에서 구제를 허용하기 전에 전제 조건(사용자 자격, 리소스 이용 가능 여부 등)을 확인하는 데 사용됩니다.
action 필드는 검증 액션의 종류를 지정하고, request 필드에는 그에 대응하는 요청 매개변수가 포함됩니다.

AcquireAction

획득 액션

획득 액션의 구조를 통해 사용자에게 리소스를 부여하는 액션을 정의합니다.
보상 내에서 사용되며, 사용자가 받는 것(인벤토리에 아이템 추가, 화폐 부여, 경험치 부여 등)을 지정합니다.
action 필드는 획득 액션의 종류를 지정하고, request 필드에는 그에 대응하는 요청 매개변수가 포함됩니다.