번들 준비하기

ZIP 번들로 게임을 올릴 때 지켜야 하는 구조와 크기 제한입니다. 업로드할 때 서버가 같은 규칙으로 검사합니다.

폴더 구조

웹 빌드 결과 폴더를 그대로 ZIP 으로 묶습니다. 따로 정하지 않으면 ZIP 맨 위의 index.html 을 실행 파일로 씁니다.

game.zip
  index.html            실행 파일
  gamjoy.manifest.json  (선택) 실행 파일이 다른 이름·폴더일 때
  assets/
  src/

실행 파일이 다른 이름이거나 하위 폴더에 있으면 ZIP 맨 위에 gamjoy.manifest.json 을 두고 entrypoint 에 ZIP 안의 경로를 적습니다.

{
  "entrypoint": "build/game.html"
}

아래 확장자만 올릴 수 있습니다. 목록에 없는 파일이 하나라도 있으면 업로드가 거절됩니다. macOS 가 만드는 __MACOSX/ 폴더와 .DS_Store 는 검사하지 않고 건너뜁니다.

분류	확장자
웹	`.html` `.htm` `.js` `.mjs` `.css` `.json` `.wasm`
이미지	`.png` `.jpg` `.jpeg` `.gif` `.webp` `.svg` `.ico`
소리 · 영상	`.mp3` `.ogg` `.wav` `.mp4` `.webm`
텍스처	`.pvr` `.pkm` `.astc` `.basis` `.ktx` `.ktx2`
게임 엔진 리소스	`.atlas` `.skel` `.fnt` `.plist` `.glb` `.gltf` `.data` `.bin`
글꼴 · 기타	`.ttf` `.otf` `.woff` `.woff2` `.txt` `.xml`

Cocos Creator 빌드라면 첫 번들을 올릴 때 빌드 설정의 화면 방향을 읽어 게임에 적용합니다. 두 번째 번들부터는 게임 정보에 저장된 값을 씁니다.

마지막 수정 · 2026-10-02