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

마스터 데이터 포맷

• JSON

{
  "version": "2019-02-05",
  "inventoryModels": [
    {
      "name": "[string]인벤토리 모델 이름",
      "metadata": "[string?]메타데이터",
      "initialCapacity": "[int]초기 크기",
      "maxCapacity": "[int]최대 크기",
      "protectReferencedItem": "[bool?]참조된 아이템 보호",
      "itemModels": [
        {
          "name": "[string]아이템 모델 이름",
          "metadata": "[string?]메타데이터",
          "stackingLimit": "[long]스택 가능한 최대 수량",
          "allowMultipleStacks": "[bool]복수 스택 허용",
          "sortValue": "[int]표시 순서"
        }
      ]
    }
  ],
  "simpleInventoryModels": [
    {
      "name": "[string]심플 인벤토리 모델 이름",
      "metadata": "[string?]메타데이터",
      "simpleItemModels": [
        {
          "name": "[string]심플 아이템 모델 이름",
          "metadata": "[string?]메타데이터"
        }
      ]
    }
  ],
  "bigInventoryModels": [
    {
      "name": "[string]거대 인벤토리 모델 이름",
      "metadata": "[string?]메타데이터",
      "bigItemModels": [
        {
          "name": "[string]거대 아이템 모델 이름",
          "metadata": "[string?]메타데이터"
        }
      ]
    }
  ]
}

모델

InventoryModel

인벤토리 모델

인벤토리는 게임 플레이어가 소유한 아이템을 담는 가방과 같은 것입니다.
인벤토리에는 용량을 설정할 수 있으며, 용량을 초과하여 소유할 수 없습니다.

ItemModel

아이템 모델

아이템은 포션 ×99 처럼, 하나의 인벤토리 칸에 여러 개를 모아서 소지할 수 있습니다.
이렇게 한 칸에 여러 개를 모으는 것을 “스택"이라고 하며, 아이템마다 스택 가능한 상한 수를 설정할 수 있습니다.

스택 상한에 도달했을 때의 동작도 아이템마다 설정할 수 있습니다.
구체적으로는 다음 중 하나를 선택할 수 있습니다:

• 새로운 인벤토리 칸을 추가하여 추가로 소지할 수 있도록 한다
  
• 상한에 도달했으므로 더 이상 입수할 수 없도록 한다

SimpleInventoryModel

심플 인벤토리 모델

일반적인 InventoryModel에서는 인벤토리 안에 저장할 수 있는 아이템의 용량 제한을 설정할 수 있었습니다.
하지만 심플 인벤토리에는 그러한 기능이 없으며, 단순히 아이템의 소지 수량을 보유할 뿐입니다.

다만 심플 인벤토리에서는 여러 아이템의 증감 처리를 한 번의 처리로 실행할 수 있는 API를 사용할 수 있습니다.

SimpleItemModel

심플 아이템 모델

ItemModel에서는 스택할 수 있는 수량의 최댓값을 설정할 수 있어, 일정 수를 초과하는 경우 여러 스택으로 나누는 구현이 가능했습니다.
심플 아이템에는 그러한 기능이 없으며, 단순히 아이템의 소지 수량만을 보관합니다.

BigInventoryModel

거대 인벤토리 모델

일반적인 InventoryModel이나 SimpleInventoryModel에서는 인벤토리에 저장할 수 있는 아이템의 수가 int64 범위로 제한되었습니다.
인플레이션 계열 게임에서는 더 넓은 범위의 값이 필요한 경우가 있습니다.

거대 인벤토리 모델에서는 인벤토리에 저장할 수 있는 아이템의 수가 최대 1024자리의 정수값을 가질 수 있습니다.

BigItemModel

거대 아이템 모델

거대 아이템 모델은 거대 인벤토리 모델에 저장되는 거대 아이템을 정의하는 모델입니다.
거대 아이템은 소지 수량을 int64 범위를 초과하여 보유할 수 있습니다.