업로드 전 체크리스트
올리기 전에 아래 항목을 확인해 주세요. 검토자도 같은 목록으로 확인하고, 거절할 때는 어느 항목 때문인지 제작자 페이지에 알려 드려요.
"필수"는 업로드할 때 허브가 막거나 검토자가 확인하는 항목이에요. "권장"은 지키면 플레이어가 더 오래 머무는 항목이고, 이것만으로 거절하지는 않아요.
크기와 시작 시간
- 필수 올리는 zip은 20MB, 파일 1000개까지예요. 파일 하나는 8MB, 압축을 푼 전체는 50MB를 넘을 수 없어요. 넘으면 업로드가 거절돼요.
- 권장 첫 화면까지 받는 양은 20MB 이하로, 중급 휴대폰에서 10초 안에 게임이 시작되게 해 주세요. 링크로 올리는 게임도 같아요.
- 권장 음악이나 큰 이미지는 처음에 한꺼번에 받지 말고 필요할 때 불러오세요.
바로 게임 시작
- 권장 로고 화면, 타이틀 화면, 메뉴를 거치지 않고 바로 게임이 시작되게 해 주세요. 한 번 눌러서 시작하는 정도면 충분해요.
- 필수 검토자가 직접 해 봐요. 게임이 시작되지 않거나 플레이 중에 멈추면 거절돼요.
조작과 폰 지원 표시
- 필수 올릴 때 조작 방식(키보드, 마우스, 터치)을 하나 이상 골라야 해요. 검토자가 실제와 맞는지 확인하고, 다르면 고친 뒤 공개해요.
- 권장 터치는 휴대폰에서 직접 해 본 뒤에 고르세요. 터치를 고른 게임만 "폰에서 가능"에 나와요.
진행 저장
- 필수 올린 파일로 하는 게임은 격리된 칸에서 돌아가서 브라우저 저장소(localStorage, IndexedDB, 쿠키)를 쓸 수 없어요. 저장소에 접근하면 오류가 나니 try/catch로 감싸서 게임이 멈추지 않게 해 주세요.
- 필수 레벨이나 해금처럼 이어서 할 진행이 있는 게임이면 "이 게임은 진행 상황이 저장되지 않아요"에 체크하세요. 게임 페이지에 안내가 붙어요.
쓸 수 없는 브라우저 기능
- 필수 alert(), confirm(), prompt() 창은 뜨지 않아요. 안내나 확인은 게임 화면 안에 그려 주세요.
- 필수 포인터 잠금(마우스 가두기)은 쓸 수 없어요. 마우스를 가두지 않아도 되는 조작으로 만들어 주세요.
- 필수 새 창 열기, 폼 전송, 파일 다운로드, 다른 페이지로 이동하기도 막혀 있어요.
- 필수 다른 사이트나 서버로 보내는 요청은 막혀 있어요. 게임에 넣은 파일(JSON, 텍스트, 이미지, 소리, 글꼴)은 fetch()나 XMLHttpRequest에 "levels/1.json"처럼 상대 주소를 써서 읽을 수 있어요.
점수 보내기
- 필수 공개하는 게임은 첫 페이지(index.html)에 <script src="/sdk/v1.js"></script>를 꼭 넣어야 해요. 공개 게임, 비공개 게임, 검토 미리 보기 모두 이 경로 그대로예요. 검토할 때 허브가 올린 파일에서 이 줄을 자동으로 찾고, 없으면 검토자가 예외로 받아들일 때만 공개돼요. https://로 시작하는 전체 주소나 SDK 사본은 넣은 것으로 보지 않아요. 비공개 게임은 SDK 없이도 열 수 있고, 공개를 요청할 때 확인해요.
- 필수 수명 이벤트를 꼭 보내 주세요. 게임이 준비되면 JonGem.ready(), 한 판을 시작할 때 JonGem.start(), 판이 끝나면 JonGem.end()예요. 점수는 끝나기 전에 JonGem.score(점수판, 점수)로 보내요. 판이 끝나면 게임 화면 아래 "이번 점수"에 보이고, 앞으로 랭킹에 쓰여요.
- 필수 올릴 때 점수판을 1–5개 정해요. 게임이 점수를 보내는 점수판 id는 정한 것과 같아야 해요. 정하지 않은 점수판에 보낸 점수는 랭킹에 오르지 않아요.
- 필수 점수판마다 실제로 나올 수 있는 최솟값과 최댓값을 적어 주세요. 범위를 벗어난 점수는 거절하거나, 확인할 때까지 순위에 올리지 않아요.
- 권장 장난감이나 이야기처럼 점수가 의미 없는 게임도 "완료 시간"(시간, 낮을수록 좋음) 같은 점수판으로 대신할 수 있는지 먼저 생각해 보세요.
- 필수 정말 점수가 없다면 업로드할 때 "이 게임에는 점수가 없습니다"를 체크하세요. 그래도 SDK와 ready, start, end는 넣어 주세요. 검토자가 점수 없는 게임인지 확인하고 예외로 받아들일지 정해요.
- 권장 올린 뒤 제작자 페이지의 미리 보기 아래 "SDK 테스트"에서 게임이 보낸 이벤트와 점수를 바로 볼 수 있어요. 정하지 않은 점수판에 보내면 거기서 알려 줘요.
- 권장 점수판 이름은 영어 소문자로 시작하고 영어 소문자, 숫자, 밑줄(_)로 32자까지예요(예: best_score). 점수는 0 이상의 정수이고, 한 판에 점수판은 5개까지예요. 판 도중의 값은 JonGem.progress(점수판, 값)로 보내요.
- 필수 "재현 가능"으로 정한 점수판은 상위 기록을 서버가 같은 시드와 입력으로 다시 돌려 확인해요. 게임은 JonGem.ready({ start: 판을_시작하는_함수 })로 준비를 알리고, 판을 JonGem.start(function () { ... })의 함수 안에서 시작하고, 고정된 한 단계마다 입력을 0–16777215 정수(키를 비트로 묶은 값 등)로 JonGem.tick(입력)에 넘긴 뒤 돌려받은 값만 써야 해요. 난수는 JonGem.random()만 쓰고, 판이 시작되기 전에는 아무것도 움직이지 않아야 하며, 시각(Date, performance)이나 화면 픽셀이 점수에 영향을 주면 안 돼요. 하나라도 어기면 상위 기록이 "다시 돌린 결과가 다름"으로 보류돼요.
- 권장 내 컴퓨터에서 파일로 열면 SDK가 없어요. 아래처럼 window.JonGem이 있을 때만 부르면 게임이 멈추지 않아요.
<script src="/sdk/v1.js"></script>
<script>
const jongem = window.JonGem;
jongem?.ready();
function startRound() {
jongem?.start();
}
function endRound(score) {
jongem?.score('best_score', score);
jongem?.end();
}
</script>
커버, 스크린샷, 소개
- 필수 커버 이미지는 꼭 있어야 해요. PNG, JPG, WebP 중 하나인 움직이지 않는 이미지로, 16:9나 16:10 비율, 1280×720 이상, 2MB까지예요.
- 권장 스크린샷은 실제 게임 화면으로 4장까지, 장당 2MB까지 올릴 수 있어요. 한두 장만 있어도 플레이어가 고르기 쉬워져요.
- 필수 커버, 스크린샷, 제목, 설명은 실제 게임과 맞아야 해요. 다른 게임처럼 보이게 꾸미면 거절돼요.
- 필수 태그는 게임에 맞는 것만 달아 주세요. 관계없는 태그를 잔뜩 달면 거절돼요.
- 권장 AI 도구로 만들었다면 "사용한 AI 도구" 칸에 적어 주세요(예: Claude, Cursor). 게임 페이지에 표시돼요.
직접 만든 게임
- 필수 다른 게임을 그대로 베낀 게임, 산 에셋이나 템플릿에 거의 손대지 않고 올린 게임(에셋 플립)은 받지 않아요.
- 필수 같은 게임을 여러 번 올리지 마세요. 고친 버전은 제작자 페이지에서 새 버전으로 올리면 돼요.
- 필수 쓴 이미지, 음악, 코드의 출처와 권리를 확인할 수 있어야 해요. 확인할 수 없으면 거절돼요.
콘텐츠 규칙
- 필수 누구나 할 수 있는 게임만 받아요. 성인·선정적인 내용, 지나친 폭력이나 혐오, 도박을 흉내 낸 게임은 받지 않아요. 자세한 기준은 이용약관에 있어요.
- 필수 다른 작품의 캐릭터나 세계관을 빌린 팬 게임은 팬 게임으로 표시하고 원작과 권리자를 적어야 해요. 원작의 이미지, 음악, 코드를 그대로 쓰면 받지 않아요.