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

마스터 데이터 포맷

• JSON

{
  "version": "2020-08-22",
  "rateModels": [
    {
      "name": "[string]강화 레이트 모델 이름",
      "description": "[string?]설명문",
      "metadata": "[string?]메타데이터",
      "targetInventoryModelId": "[string]강화 대상으로 사용할 수 있는 GS2-Inventory 인벤토리 모델의 GRN",
      "acquireExperienceSuffix": "[string]GS2-Experience에서 획득한 경험치를 저장하는 프로퍼티 ID에 부여하는 서픽스",
      "materialInventoryModelId": "[string]강화 소재로 사용할 수 있는 GS2-Inventory 인벤토리 모델 GRN",
      "acquireExperienceHierarchy": [
        "[string]ItemModel의 메타데이터에 저장할, 획득 경험치를 정의하는 JSON 데이터의 계층 구조 정의"
      ],
      "experienceModelId": "[string]강화 결과로 얻는 GS2-Experience 경험치 모델 GRN",
      "bonusRates": [
        {
          "rate": "[float]경험치 보너스 배율 (1.0 = 보너스 없음)",
          "weight": "[int]추첨 가중치"
        }
      ]
    }
  ],
  "unleashRateModels": [
    {
      "name": "[string]한계돌파 레이트 모델명",
      "description": "[string?]설명문",
      "metadata": "[string?]메타데이터",
      "targetInventoryModelId": "[string]한계돌파 대상에 사용할 수 있는 GS2-Inventory 인벤토리 모델 GRN",
      "gradeModelId": "[string]그레이드 모델 GRN",
      "groupKeyHierarchy": [
        "[string]ItemModel의 메타데이터에 저장할, 그룹 키를 정의하는 JSON 데이터의 계층 구조"
      ],
      "gradeEntries": [
        {
          "gradeValue": "[long]대상 그레이드",
          "type": "[string]소재 조건의 종류",
          "needCount": "[int]동일 종류의 아이템을 몇 개 소비할지",
          "recipes": [
            {
              "name": "[string]레시피 이름",
              "metadata": "[string?]메타데이터",
              "targetGroupKeys": [
                "[string]그룹 키"
              ],
              "materials": [
                {
                  "name": "[string]소재 이름",
                  "materialType": "[string]소재의 종류",
                  "individualSetting": {
                    "matchType": "[string]소재와 한계돌파 대상의 일치 조건",
                    "gradeCondition": "[string]소재의 그레이드 조건",
                    "gradeValue": "[long]소재에 요구하는 그레이드",
                    "count": "[int]소비할 아이템 세트의 수"
                  },
                  "quantitySetting": {
                    "matchType": "[string]소비할 아이템 모델을 정하는 방법",
                    "materialInventoryModelId": "[string]소재를 찾을 GS2-Inventory 인벤토리 모델 GRN",
                    "itemModelId": "[string]소비할 GS2-Inventory 아이템 모델 GRN",
                    "count": "[int]소비할 수량"
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

모델

RateModel

강화 레이트 모델

강화 레이트는 강화에 사용하는 소재와 강화 대상을 정의한 데이터입니다.

소재 데이터와 강화 대상 데이터는 모두 GS2-Inventory에서 관리되고 있어야 합니다.
강화로 얻는 경험치는 GS2-Inventory의 메타데이터에 JSON 형식으로 기록됩니다.
여기서는 메타데이터의 어느 계층에 경험치 값이 저장되어 있는지를 기재해야 합니다.

강화 시 일정 확률로 대성공과 같은 형태로 입수할 수 있는 경험치량에 보정값을 적용할 수 있습니다.
그 추첨 확률도 이 엔티티에서 정의합니다.

targetInventoryModelId 에는 강화 대상이 되는 아이템을 보유하는 인벤토리 모델을, materialInventoryModelId 에는 소재로 사용할 수 있는 아이템을 보유하는 인벤토리 모델을 지정합니다.
양쪽은 서로 다른 인벤토리 모델로 할 수 있으므로, 캐릭터를 강화 대상으로 하고 강화 전용 아이템을 소재로 하는 구성이 가능합니다.

각 소재가 제공하는 경험치는 소재 아이템의 아이템 모델 메타데이터에 기술하며, 그 JSON의 어디에 값이 들어 있는지를 acquireExperienceHierarchy 로 지정합니다.
{ "aaa": { "bbb": { "experienceValue": 100 } } } 와 같은 구조라면 [ "aaa", "bbb", "experienceValue" ] 와 같이 지정합니다. 계층은 최대 10단계까지 지정할 수 있습니다.

획득한 경험치는 experienceModelId 로 지정한 GS2-Experience 의 경험치 모델에 가산됩니다.
가산 대상 프로퍼티 ID는 강화 대상 아이템의 프로퍼티 ID에 acquireExperienceSuffix 를 부여한 것이 됩니다. 이를 통해 하나의 아이템에 캐릭터 레벨의 level 과 호감도의 like 같은 여러 종류의 경험치를 가지게 할 수 있습니다.

bonusRates 에는 획득 경험치에 적용할 배율의 가중치 추첨을 정의합니다.
각 항목은 배율(1.5 라면 150%)과 배출 가중치를 가지며, 강화를 실행할 때마다 가중치 추첨으로 하나가 선택됩니다. 항목은 최대 1,000건까지 등록할 수 있습니다.

BonusRate

경험치 획득량 보너스

강화 시 경험치 보너스 배율을 결정하는 가중치 추첨의 단일 항목을 정의합니다. 서로 다른 배율과 가중치를 가진 여러 항목을 설정함으로써, 제어된 확률에 따른 “대성공"이나 “초성공” 같은 시스템을 구현할 수 있습니다.

UnleashRateModel

한계돌파 레이트 모델

아이템의 한계돌파(해방) 조건을 정의합니다.

여기서 말하는 한계돌파란, 동일 종류의 아이템을 소재로 소비함으로써 GS2-Grade 에서 관리하는 그레이드를 끌어올리는 강화 처리입니다.
그레이드가 올라가면 GS2-Experience 측의 랭크 캡이 상향되어, 대상을 더 높은 레벨까지 육성할 수 있게 됩니다.

targetInventoryModelId 에는 한계돌파 대상이 되는 아이템을 보유하는 GS2-Inventory 의 인벤토리 모델을 지정합니다.
한계돌파하는 아이템과 소재로 소비하는 동일 종류 아이템 모두 이 인벤토리 모델에 속해 있어야 합니다.
gradeModelId 에는 대상 아이템의 그레이드를 추적하는 GS2-Grade 의 그레이드 모델을 지정합니다. 한계돌파에 성공하면 해당 그레이드가 1 상향됩니다.

gradeEntries 에는 각 그레이드에 도달하기 위해 소비하는 동일 종류 아이템의 수를 그레이드별로 정의합니다. 엔트리는 1건 이상 1,000건까지 등록할 수 있습니다.
예를 들어 그레이드 1은 1개, 그레이드 2는 3개와 같이 설정함으로써 한계돌파 단계마다 비용을 개별적으로 제어할 수 있습니다.

소재로 소비한 리소스는 그 리소스가 보유하고 있던 내용과 함께 사라집니다.
소재가 경험치 등의 리소스를 가지고 있더라도 대상에게 인계되지 않으므로, 인계가 필요한 경우에는 사전에 인계용 리소스로 변환해 두어야 합니다.

UnleashRateEntryModel

한계돌파 레이트 엔트리 모델

한계돌파 진행에서 단일 그레이드 레벨의 소재 비용을 정의합니다. 각 엔트리는 대상이 되는 그레이드 값과, 해당 그레이드를 달성하기 위해 소비해야 하는 동일 종류 아이템의 수를 지정합니다.

UnleashRecipe

한계돌파 레시피

그레이드를 1단계 올리는 방법 중 하나입니다. 그레이드 엔트리에 여러 레시피가 있는 경우, 플레이어는 그중 하나를 선택하며, 선택한 레시피의 소재는 모두 필요합니다.

UnleashMaterial

한계돌파 소재

레시피가 필요로 하는 소재의 1종류를 정의합니다.
“개체(individual)“는 장비의 복제처럼, 플레이어가 선택한 아이템 세트를 소비합니다.
“수량(quantity)“은 범용 강화 소재처럼, 설정으로 정해지는 아이템을 수량으로 소비합니다.

UnleashIndividualMaterialSetting

개체 소재 설정

장비의 복제처럼, 아이템 세트를 개체로서 소비하는 소재를 정의합니다.
어떤 아이템 세트를 소비할지는 플레이어가 선택하며, 선택된 아이템 세트는 한계돌파 대상 아이템과 같은 인벤토리 모델에 속해 있어야 합니다.
개체마다 GS2-Grade의 그레이드를 가질 수 있으므로, 소재의 그레이드를 조건으로 할 수도 있습니다.

UnleashQuantityMaterialSetting

수량 소재 설정

범용 강화 소재처럼, 수량으로 소비하는 소재를 정의합니다.
플레이어는 아이템을 선택하지 않으며, 소비할 아이템 모델은 이 설정으로 정해지고, 지정한 수량이 소비됩니다.
GS2-Inventory의 일반 인벤토리와 심플 인벤토리 모두 사용할 수 있습니다.