주로 GM / 에셋 제작자
카드 ZIP 가져오기 FAQ
독자적인 카드 세트를 ZIP으로 추가할 때 필요한 형식, 제한과 오류 대응을 설명합니다.
최종 업데이트: 2026년 9월 21일
기본 구조
manifest.json을 사용할 때는 ZIP을 열었을 때 바로 보이는 최상위 경로에 두세요. 카드 이미지는 cards/ 같은 폴더에 넣을 수 있습니다.
압축할 때는 manifest.json과 cards 폴더를 함께 선택하여 ZIP으로 만드세요.
상위 폴더를 통째로 압축하여 my-card-set/manifest.json처럼 폴더 안에 넣으면 manifest를 읽지 않고 이미지 전용 ZIP으로 처리합니다. 지정한 카드 이름과 크기는 반영되지 않으며, 기본 크기는 180 × 252가 됩니다.
이미지만으로 가져올 때는 manifest.json을 생략할 수 있습니다. 카드 이름, 크기와 라이선스 정보를 지정하려면 포함하세요.
이미지 경로의 대소문자와 확장자를 정확히 맞추고, 암호화 ZIP이나 실행 파일을 포함하지 마세요.
가져오기 전 확인
- 파일명 충돌과 누락된 이미지 참조가 없는지 확인합니다.
- 이미지 수와 전체 용량이 계정의 에셋 제한 안에 있는지 확인합니다.
- 카드의 앞면·뒷면, 이름과 장수가 의도한 값인지 미리보기에서 확인합니다.
오류가 날 때
ZIP이 열리지 않으면 폴더 자체가 아니라 내부 파일을 묶었는지, 정의 파일의 JSON 문법이 올바른지, 참조 경로가 실제 파일과 일치하는지 확인하세요. 실패한 가져오기는 오류 메시지를 수정한 뒤 다시 시도합니다.