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

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

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




## 마스터 데이터 포맷


**JSON**
```json
{
  "version": "2020-04-30",
  "categoryModels": [
    {
      "category": "[int]카테고리",
      "rejectAccessTokenPost": "[문자열 열거형?]플레이어의 액세스 토큰을 이용한 게시를 거부한다"
    }
  ]
}
```


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| version | string | | ✓ | 2020-04-30 | | 마스터 데이터 포맷 버전 |
| categoryModels | [List&lt;CategoryModel&gt;](#categorymodel) |  |  |  |  ~ 1000 items | 메시지 카테고리 모델<br>메시지 카테고리 모델은 채팅 룸에 게시되는 메시지를 분류하기 위한 카테고리를 정의합니다.<br>각 카테고리는 숫자로 식별되며, 카테고리별로 플레이어의 액세스 토큰을 사용한 게시를 허용할지 거부할지 설정할 수 있습니다.<br>이를 통해 서버만 게시할 수 있는 시스템 안내 카테고리 등의 사용 사례를 구현할 수 있습니다. |

## 모델

### CategoryModel

메시지 카테고리 모델<br>

메시지 카테고리 모델은 채팅 룸에 게시되는 메시지를 분류하기 위한 카테고리를 정의합니다.<br>
각 카테고리는 숫자로 식별되며, 카테고리별로 플레이어의 액세스 토큰을 사용한 게시를 허용할지 거부할지 설정할 수 있습니다.<br>
이를 통해 서버만 게시할 수 있는 시스템 안내 카테고리 등의 사용 사례를 구현할 수 있습니다.

|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| categoryModelId | string |  | ※ |  |  ~ 1024자 | 메시지 카테고리 모델 GRN<br>※ 서버가 자동으로 설정 |
| category | int |  | ✓ |  | 0 ~ 2147483645 | 카테고리<br>메시지 카테고리의 숫자 식별자입니다. 이 카테고리 번호로 게시된 메시지는, 플레이어의 게시를 허용할지 여부 등 이 모델에서 정의된 규칙을 따릅니다. |
| rejectAccessTokenPost | 문자열 열거형<br>enum {<br>"Enabled",<br>"Disabled"<br>}<br> |  |  |  |  | 플레이어의 액세스 토큰을 이용한 게시를 거부한다<br>활성화하면, 이 카테고리에서는 서버 사이드 API 호출(사용자 ID 지정)만으로 메시지를 게시할 수 있습니다. 플레이어가 직접 게시해서는 안 되는 시스템 안내나 서버 생성 메시지에 유용합니다.Enabled: 액세스 토큰을 이용한 게시를 거부한다 / Disabled: 액세스 토큰을 이용한 게시를 허용한다 /  |

---