에이전트로 제작하고 업로드하기

CLI 설치와 로그인을 마친 게임 폴더에서 에이전트를 실행하세요. 터미널을 실행할 수 있는 에이전트라면 별도 연결 설정 없이 사용할 수 있습니다.

컨트롤러 제작과 업로드

immercy help로 규격을 확인하고 immercy project --json으로 프로젝트를 확인해 줘.
immercy init으로 기본 파일을 준비해 줘.
가로 화면에 왼쪽 조이스틱(move), 오른쪽 점프 버튼(jump)이 있는 컨트롤러 웹페이지를 React·TypeScript·Vite로 만들어 정적 빌드해 줘.
immercy controller validate --json으로 검증하고 immercy controller upload --json으로 업로드해 줘.
immercy preview --json으로 컨트롤러 프리뷰 주소를 알려줘.

컨트롤러 단독 업로드에는 게임 빌드가 필요하지 않습니다. 플랫폼은 controllerBuildDir의 index.html과 정적 에셋을 검증·업로드합니다.

게임 입력 연결

immercy help game을 읽고 생성된 immercy-runtime.mjs를 내 게임에 연결해 줘.
move를 이동에, jump를 점프에 사용해 줘.
연결이 끊기면 입력을 초기화하고 종료 시 destroy()를 호출해 줘.
입력 모듈과 에셋은 정적 빌드에 포함하고 상대 경로를 사용해 줘.

빌드 업로드

게임과 컨트롤러의 빌드 명령을 실행해 줘.
immercy validate --json을 통과하면 immercy deploy --json으로 빌드와 컨트롤러를 함께 업로드해 줘.
immercy preview --json으로 통합 프리뷰 주소를 알려줘.
업로드 결과와 실제 스마트폰 입력 검증 여부를 구분해 알려줘.

출시와 공유

프리뷰 확인을 마친 뒤 원하는 공개 범위를 지정해 요청하세요.

immercy release --json으로 현재 상태를 확인하고 링크 공개(unlisted)로 출시해 줘.
서버에서 반환한 공개 범위와 검토 상태를 확인해 줘.
release.available이 true이면 release.shareUrl을 알려줘. 검토 중이거나 차단됐다면 그 상태와 다음 단계를 알려줘.

출시 상태 확인만 원한다면 immercy release --json을 요청하세요. 빌드 배포는 기존 공개 범위를 유지하며 이미 출시된 게임에도 반영됩니다.

로그인이 필요하면 사용자가 터미널에서 immercy login으로 키를 입력합니다. 에이전트 요청문·소스·브라우저 코드에 API Key를 넣지 않습니다.