> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Distributor 마스터 데이터 레퍼런스

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




## 마스터 데이터 포맷


**JSON**
```json
{
  "version": "2019-03-01",
  "distributorModels": [
    {
      "name": "[string]배포 모델 이름",
      "metadata": "[string?]메타데이터",
      "inboxNamespaceId": "[string?]넘친 리소스를 전송할 GS2-Inbox 네임스페이스 GRN",
      "whiteListTargetIds": [
        "[string]GS2-Distributor를 통해 처리할 수 있는 대상 리소스 GRN 프리픽스"
      ]
    }
  ]
}
```


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| version | string | | ✓ | 2019-03-01 | | 마스터 데이터 포맷 버전 |
| distributorModels | [List&lt;DistributorModel&gt;](#distributormodel) |  |  |  |  ~ 100 items | 배포 모델<br>배포 모델이란 리소스 입수 시 소지 한도를 초과하여 입수했을 때의 정책을 설정하는 엔티티입니다.<br>GS2-Distributor를 통해 입수 처리를 수행함으로써, 넘친 리소스를 GS2-Inbox의 메시지로 전송할 수 있습니다. |

## 모델

### DistributorModel

배포 모델<br>

배포 모델이란 리소스 입수 시 소지 한도를 초과하여 입수했을 때의 정책을 설정하는 엔티티입니다.<br>
GS2-Distributor를 통해 입수 처리를 수행함으로써, 넘친 리소스를 GS2-Inbox의 메시지로 전송할 수 있습니다.

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| distributorModelId | string |  | ※ |  |  ~ 1024자 | 배포 모델 GRN<br>※ 서버가 자동으로 설정 |
| name | string |  | ✓ |  |  ~ 128자 | 배포 모델 이름<br>배포 모델 고유의 이름. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. |
| metadata | string |  |  |  |  ~ 2048자 | 메타데이터<br>메타데이터에는 임의의 값을 설정할 수 있습니다.<br>이 값들은 GS2의 동작에는 영향을 주지 않으므로, 게임 내에서 사용하는 정보를 저장하는 용도로 사용할 수 있습니다. |
| inboxNamespaceId | string |  |  |  |  ~ 1024자 | 넘친 리소스를 전송할 GS2-Inbox 네임스페이스 GRN<br>리소스 입수가 플레이어의 소지 한도를 초과한 경우, 넘친 리소스는 지정된 GS2-Inbox 네임스페이스에 메시지로 전송됩니다. 플레이어는 이후 수신함에서 리소스를 수령할 수 있습니다. |
| whiteListTargetIds | List&lt;string&gt; |  |  | [] | 0 ~ 1000 items | GS2-Distributor를 통해 처리할 수 있는 대상 리소스 GRN의 화이트리스트<br>이 배포 모델을 사용하여 입수 처리를 수행할 수 있는 대상 리소스의 GRN 프리픽스를 지정합니다. |

---