웹 게임을 itch.io에 올리는 법: 페이지 만들기부터 Butler까지

웹 브라우저에서 바로 실행되는 게임을 itch.io에 공개하고 싶은 제작자라면 업로드 방식과 페이지 구성 절차를 먼저 알아두는 게 좋다. 별도 다운로드나 설치 없이 플레이어가 링크만 클릭해도 게임을 실행할 수 있다는 점은 itch.io의 HTML5 지원이 가진 가장 큰 장점이다. 이 글에서는 itch.io 공식 문서를 바탕으로 페이지 개설부터 파일 업로드, 그리고 Butler라는 명령줄 도구까지 전체 흐름을 정리한다.

어떤 제작자에게 필요한가

HTML, 자바스크립트, CSS로 만든 게임을 웹에서 바로 플레이할 수 있게 공개하려는 사람에게 필요한 내용이다. 많은 게임 엔진이 HTML/자바스크립트 형태로 내보내기를 지원하기 때문에, 엔진으로 제작한 게임을 설치 없이 브라우저에서 돌리고 싶은 제작자라면 이 절차를 참고할 만하다. 또한 빌드를 반복해서 올려야 하거나 자동화된 배포 과정을 구축하려는 제작자에게는 Butler 도구가 함께 필요하다.

실제로 무엇을 할 수 있나

itch.io는 업로드한 코드를 iframe 형태로 프로젝트 페이지에 삽입해 브라우저에서 바로 게임이 돌아가게 해준다. 게임에 쓰이는 모든 자산은 itch.io 서버에 호스팅되므로 별도의 저장 공간을 따로 마련할 필요가 없다.

업로드 방식은 두 가지다.

• 프로젝트의 모든 파일을 담은 ZIP 파일을 올리는 방식. 이 안에는 게임의 시작점이 되는 index.html 파일이 반드시 포함되어야 한다.
• 단일 HTML 파일 하나로 이루어진 간단한 프로젝트라면 압축 없이 해당 파일만 올리는 방식.

게임을 페이지에 보여주는 방법도 선택할 수 있다. 지정한 크기만큼 페이지 안에 바로 삽입하는 방식과, 버튼을 눌렀을 때 전체 화면으로 확장되는 방식이 있다. 이 외에도 클릭해야 재생이 시작되도록 하는 옵션, 전체화면 버튼을 자동으로 넣는 옵션, 뷰포트보다 큰 콘텐츠를 위한 스크롤바 옵션 등을 설정으로 조정할 수 있다.

페이지 자체는 itch.io 대시보드에서 만든다. 대시보드는 계정의 모든 페이지와 판매, 조회수·다운로드·구매 등의 통계를 한곳에서 관리할 수 있는 공간이다. 새 게임 만들기 버튼을 눌러 제목, 짧은 설명, 커버 이미지 같은 기본 정보를 채우고, 콘텐츠 종류를 HTML5로 지정한 뒤 파일을 업로드하면 된다. 설명란에는 서식 기능을 활용해 섹션을 나눌 수 있고, 장르와 태그를 붙여 분류를 명확히 할 수 있다.

반복적으로 빌드를 올려야 하는 상황이라면 Butler라는 명령줄 도구를 쓸 수 있다. Butler는 게임 빌드를 itch.io에 빠르고 안정적으로 업로드하거나, 스팀에 있는 빌드를 itch.io 채널로 복사하거나, 패치를 생성해 오프라인으로 적용하는 기능을 제공한다. 명령줄 사용이 부담스럽다면 itch 앱에 포함된 그래픽 인터페이스로도 빌드 업로드와 관리가 가능하다.

사용 방법

HTML5 게임을 올리려면 먼저 새 게임 페이지를 만들거나 기존 페이지를 편집 상태로 연다. Kind Of Game 항목에서 HTML Game을 선택한 뒤, 게임을 ZIP 파일로 묶어 업로드하면 기본적인 설정은 끝난다. 파일이 여러 개라면 ZIP으로, 단일 HTML 파일이라면 압축 없이 그대로 올린다는 원칙만 기억하면 된다.

ZIP 파일을 쓸 때는 상대 경로를 사용해 자산이 제대로 로드되도록 신경 써야 하며, 파일명 대소문자도 구분된다는 점을 유의한다. 게임을 수정했다면 새 ZIP 파일을 올리고 이전 파일을 지우는 식으로 갱신하면 된다.

업로드 후에는 임베드 방식(페이지 내 삽입 또는 전체화면 실행)과 부가 옵션을 설정하고, 대시보드에서 설명, 스크린샷, 태그 등 나머지 페이지 구성 요소를 채운다. 페이지는 저장 후 미리보기로 확인할 수 있고, 준비가 끝나면 공개 범위를 Public으로 바꿔 발행한다.

Butler를 쓰려는 경우에는 먼저 Butler를 설치한 뒤 명령줄에서 빌드를 itch.io로 전송하는 흐름을 따른다. 명령줄 대신 itch 앱의 그래픽 인터페이스를 쓰면 사이드바의 빌드 관리 화면에서 업로드와 변경 사항 미리보기를 처리할 수 있다.

한계와 주의할 점

HTML5 게임은 현재 구매가 아닌 후원(도네이션) 형태로만 결제를 받을 수 있다. 게임 자체를 판매하고 싶다면 Kind of Game을 Downloadable로 바꿔야 하며, 구매 가능한 HTML5 게임 지원을 원한다면 itch.io 측에 직접 문의해야 한다.

ZIP 파일에는 몇 가지 제한이 있다. 압축 해제 후 파일 개수가 1,000개를 넘지 않아야 하고, 경로를 포함한 파일명 길이는 240자를 넘을 수 없다. 이런 제한은 남용을 막고 플레이어의 플레이 경험을 보장하기 위한 것이다.

또한 itch.io는 게임뿐 아니라 만화, 책, 사운드트랙 등 다양한 콘텐츠를 다루는 플랫폼으로 넓어지는 중이어서, 일부 메타데이터 항목은 게임이 아닌 프로젝트에는 맞지 않을 수 있다. 해당하지 않는 항목은 무시해도 된다고 안내하고 있다.

다음에 볼 것

페이지 디자인을 더 다듬고 싶다면 디자인 관련 문서를, 가격과 판매 방식을 조정하고 싶다면 가격 책정 관련 문서를 참고하면 된다. 빌드 자동화에 관심이 있다면 Butler 설치 및 사용법 문서를 이어서 보는 것이 도움이 된다.

이 글은 공식 문서를 한국어로 정리한 것이며 세부 내용은 원문을 기준으로 해 주세요.