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

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

마스터 데이터 포맷

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

모델

DistributorModel

배포 모델

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

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