파일 설명
이 문서는 Cataclysm: Bright Nights의 JSON 파일 구조와 명명 규칙을 설명합니다.
디렉토리 구조
data/json/
├── items/ # 아이템 정의
├── mapgen/ # 맵 생성
├── monsters/ # 몬스터 정의
├── recipes/ # 제작법
├── vehicles/ # 차량 정의
└── ...
파일 명명 규칙
JSON 파일은 다음 규칙을 따라야 합니다:
- 소문자 사용:
my_item.json(✓),MyItem.json(✗) - 밑줄 구분: 단어는 밑줄로 구분 (
my_awesome_item.json) - 설명적 이름: 파일 내용을 설명하는 이름 사용
- 카테고리별 그룹화: 관련 항목은 동일한 디렉토리에 보관
파일 구조
각 JSON 파일은 다음을 포함해야 합니다:
[
{
"type": "ITEM_TYPE",
"id": "unique_id",
...
}
]
모범 사례
- 단일 책임: 각 파일은 하나의 카테고리(예: 무기, 갑옷)를 포함해야 함
- 논리적 그룹화: 관련 아이템을 함께 유지 (예: 세트의 모든 갑옷 조각)
- 일관된 형식: 들여쓰기에 2칸 공백 사용
- 주석 추가: 복잡한 정의에
//주석 사용 (단, 게임에서 로드하기 전에 제거해야 함)
모드
모드는 다음과 같은 자체 디렉토리 구조를 가져야 합니다:
data/mods/my_mod/
├── modinfo.json # 모드 메타데이터
├── items/ # 모드 아이템
├── monsters/ # 모드 몬스터
└── ...