시작하기 전에

Combos는 브라우저에서 실행되는 게임을 호스팅합니다. 보통 dist에 모은 정적 웹사이트 전체를 업로드합니다. 폴더 이름이 다르면 실제 경로를 지정하세요. 제작 도구가 달라도 최종 전달 형식은 같습니다.

프로젝트별 준비물

프로젝트	준비할 내용
완성된 H5	`index.html`과 참조하는 모든 파일
HTML + JavaScript	HTML, JS, CSS, 에셋. 컴파일 불필요
Vite / Webpack	프로젝트 자체 빌드 명령으로 생성한 정적 결과물
Unity	네이티브 WebGL 내보내기 전체
Roblox	브라우저 엔진에 맞게 조정하거나 재구현한 에셋과 게임 로직

Combos CLI 설치에는 Node.js, Unity 플러그인, SDK가 필요하지 않습니다. Vite에는 자체 Node.js 환경이, Unity에는 공식 Web Build Support가 필요합니다.

파일 위치 확인


my-game/
├── source/
├── dist/
│   ├── index.html
│   └── assets/
├── cover.png
└── combos.json

프로젝트 루트에는 수정할 소스가 있습니다. ./dist는 터미널의 현재 디렉터리 기준 상대 경로입니다. cover.png와 생성된 combos.json은 루트에 둡니다. 후자는 게시된 게임과의 연결 정보이며 소스 코드가 아닙니다.

Codex에서 프로젝트 전체와 터미널을 열거나 시스템 터미널을 사용하세요. 따옴표 안의 경로를 실제 경로로 바꾸고, 공백이 있으면 따옴표를 유지합니다. 표시된 폴더에 dist와 cover.png가 있는지 확인하고, 없으면 먼저 준비하세요.


cd "/path/to/project"
pwd
ls


Set-Location "C:\path\to\project"
Get-Location
Get-ChildItem

로컬과 클라우드 작업 공간

Codex와 Cursor는 선택한 작업 공간에 파일을 만듭니다. 게시 전에 에이전트에게 전체 경로, 빌드 명령, 결과물 폴더, 미리보기 주소, 핵심 플레이 검증 결과를 요청하세요.

클라우드에서는 CLI가 설치된 환경에서 빌드·업로드하거나 프로젝트를 내려받아 로컬에서 작업할 수 있습니다. 클라우드의 127.0.0.1은 내 컴퓨터가 아닙니다. 도구가 제공하는 미리보기나 다운로드 후 로컬 서버를 사용하세요. 로컬 주소는 서버가 실행 중일 때만 작동하지만 Combos 공유 링크는 독립적으로 작동합니다.

예제 읽는 법

명령은 지정된 환경과 디렉터리에서 실행합니다. 경로, 제목, 커버, 기기 설정은 자신의 값으로 바꾸세요. BoatAttack의 커밋·패치와 Ball Game의 좌표는 해당 예제 전용입니다. Lua/JavaScript 코드는 구현 설명이며 터미널 명령이나 범용 변환 스크립트가 아닙니다.

출처: Combos 개발자 연동 가이드 . 원문 확인일: 2026-10-08, CLI v1.14.2. 예제 결과는 원문에 기록된 실행 결과입니다.