게임 업로드 안내

1. 브라우저 실행본 준비

HTML5 게임의 배포 결과물을 ZIP으로 압축합니다. 소스 프로젝트, node_modules, 서버 실행 파일은 넣지 않습니다. 파일명은 영문·숫자·하이픈·밑줄로 작성하고, 파일 참조에는 ./assets/main.js처럼 상대 경로를 사용하세요.

2. 게임 정보와 이미지 준비

업로드 화면에서 제목, 설명, 분류, 버전, 네트워크 방식을 입력합니다. 목록에 표시할 대표 이미지 1장과 상세 페이지에 표시할 게임 이미지 1~5장을 함께 선택하세요. 이미지는 PNG, JPG, WebP를 지원합니다. 대표 이미지는 3:2, 게임 이미지는 가로형 16:9 또는 모바일 게임용 세로형 9:16을 권장하며 세로 이미지는 잘리지 않고 세로 카드로 표시됩니다.

기존 자동화 업로드를 위해 game.json도 계속 지원합니다. 폼 업로드에서는 game.json이 없어도 되며, 폼에 입력한 정보가 우선 적용됩니다.

등록 후에는 내 게임 관리에서 현재 대표 이미지와 게임 이미지를 확인할 수 있습니다. 대표 이미지는 단독으로 교체할 수 있고, 게임 이미지는 기존 이미지를 한 장씩 삭제하거나 새 이미지만 추가할 수 있습니다. 변경한 최종 이미지 구성은 관리자 승인 후 공개됩니다.

{
  "name": "나의 게임",
  "description": "게임의 목표와 조작 방법을 소개합니다.",
  "version": "1.0.0",
  "category": "single",
  "entry": "index.html",
  "network": "none"
}

분류는 single(싱글), battle(대전), party(파티) 중 하나입니다. 새 버전은 내 게임 관리에서 게임을 선택한 뒤 version을 변경해 올리세요.

3. ZIP 업로드와 게시

ZIP 최상위에는 index.html이 있어야 합니다. ZIP 100MB, 압축 해제 200MB, 파일·폴더 1,000개 이하를 지원합니다. 대표 이미지는 5MB, 게임 이미지는 각 4MB, 이미지 전체는 20MB 이하여야 합니다. 파일 검사 후 1시간 미리보기 링크를 만들 수 있습니다. 운영 환경에서는 관리자 승인 후 게시되며, 업데이트 승인 전에는 이전 게시 버전이 유지됩니다.

4. 게임 실행 환경

게임은 계정 페이지와 분리된 출처에서 실행됩니다. 외부 API·외부 스크립트·서비스 워커·상위 페이지 이동·새 창 열기는 제한됩니다. 필요한 리소스는 패키지에 포함하세요. 별도 서버가 필요한 게임은 현재 업로드 규격에 해당하지 않습니다.

5. 친구 대전

일반 웹 게임은 SDK 없이 실행됩니다. 플랫폼의 친구 초대와 대전을 이용하려면 PLAY COKO SDK 연동이 필요합니다. 현재 play-v1은 리프트 아레나 연동 규격이며, 임의의 게임에 자동으로 멀티플레이를 추가하지 않습니다. 운영에서는 게시 승인 후 공통 연결 서비스가 해당 게임을 허용합니다.

리프트 아레나 시험 ZIP 다운로드

검토 상태와 다음 행동

상태	다음 행동
파일 저장 중	저장이 끝날 때까지 기다린 뒤 내역을 새로고침하세요.
검토 대기	미리보기로 확인하세요. 운영자가 실행·콘텐츠를 검토한 뒤 승인하거나 수정 의견을 남깁니다.
수정 요청	검토 의견을 반영하고 버전 번호를 올려 다시 업로드하세요.
게시 중	이용자가 게임 목록에서 실행할 수 있습니다. 개발자가 게시를 내릴 수 있습니다.
보관된 버전	이전 버전 또는 게시를 내린 버전입니다. 운영자는 이 버전을 다시 게시할 수 있습니다.
삭제 대기	게임의 모든 버전이 비공개 상태입니다. 30일 안에는 복원할 수 있고, 이후에는 게임명을 다시 입력해 영구 삭제할 수 있습니다.
업로드 실패	패키지 규격과 연결 상태를 확인한 뒤 다시 업로드하세요.

게시 후 제목·설명·카테고리·이미지를 수정해도 즉시 공개되지 않습니다. 변경 전후 내용과 새 이미지를 운영자가 다시 검토하고 승인한 뒤에만 게시 정보에 반영됩니다.

게임 관리의 버전 저장공간 정리에서는 현재 게시본과 가장 최근 롤백용 보관본을 남기고, 오래된 보관본과 실패한 업로드 파일만 영구 삭제할 수 있습니다. 삭제될 버전 수와 예상 용량을 확인한 뒤 실행하세요.

검토 완료 시간은 현재 보장하지 않습니다. 승인·수정 의견은 내 게임 관리에서 확인하세요.

게시 전 확인 사항

시작부터 종료까지 플레이가 가능하고 오류가 없는지 확인하세요.
PC와 모바일 화면에서 조작·텍스트·소리를 확인하세요.
배포 권한이 있는 코드·이미지·음원만 사용하세요.
비밀키·개인정보를 파일에 포함하지 말고, 소개와 실제 게임 내용을 일치시키세요.

자주 발생하는 업로드 오류

필수 파일 없음: ZIP 안에 상위 폴더를 한 겹 더 넣지 않았는지 확인하세요.
중복 버전: 내 게임 관리에서 version을 올려 다시 업로드하세요.
파일 형식·경로 오류: 실행 파일, node_modules, 한글·공백 파일명을 제외하세요.
용량 초과: 미사용 자산을 제거하고 이미지·음원을 최적화하세요. 과도한 압축률도 거부됩니다.

SDK와 친구 대전 연동 가이드 →