# Cloudflare 업로드 / Workers 배포

PC 일반 모드와 Quest VR을 같은 HTTPS 웹페이지에서 플레이합니다. 원작 MM3 BGM 5곡과 24개 SFX cue를 포함하며 런타임에 외부 음원 서버를 호출하지 않습니다.

## Cloudflare Pages에 바로 업로드: rockman3d-pages.zip

이 ZIP의 최상위에 **index.html**이 있습니다. 압축을 풀지 않고 Pages의 Direct Upload 화면에 올립니다. 게임 코드·엔진·로컬 Three·Ogg 원작 음원·루프 manifest·HUD가 모두 들어 있습니다. `rockman3d-cloudflare.zip`과 `rockman-vr-web.zip`도 같은 정적 파일 묶음입니다.

기존 `rman3dtest` 프로젝트에서는 **Create a new deployment → Production → rockman3d-pages.zip 업로드 → Save and Deploy** 순서입니다. 완료 후 `https://rman3dtest.pages.dev/`에서 Ctrl+F5로 새 버전을 엽니다. ZIP 최상위가 `public/`인 Workers 프로젝트 ZIP이나 개발 소스 ZIP은 이 업로드 화면에 사용하지 않습니다. [Pages Direct Upload 공식 문서](https://developers.cloudflare.com/pages/get-started/direct-upload/)는 대시보드에서 ZIP과 폴더 업로드를 모두 지원한다고 명시합니다.

`2026-11-16-pages-boot2`부터는 첫 3D 프레임을 그리면 플레이 버튼이 켜지며 음원 다운로드를 기다리지 않습니다. 음원 다운로드는 파일마다 15초로 제한합니다. 모듈 누락·WebGL 컨텍스트 생성 실패·지원되지 않는 모듈 로더는 별도 오류로 표시합니다. **오류 상세**를 열면 오류 코드와 브라우저 정보를 확인할 수 있습니다. 단순 지연 안내가 기존 오류를 덮어쓰지 않습니다. `404.html`을 포함해 Pages가 누락된 JS를 게임 HTML로 대체하지 않게 했습니다.

Cloudflare가 제공하는 [Cloudflare Drop](https://www.cloudflare.com/drop/)에 ZIP을 올려 웹페이지를 확인할 수 있습니다. [공식 안내](https://developers.cloudflare.com/changelog/post/2026-07-08-cloudflare-drag-and-drop/)에 따르면 처음에는 1시간 미리보기이며, 계속 유지하려면 **Claim**으로 계정에 연결합니다. 별도의 게임 빌드 명령이 필요하지 않습니다.

Cloudflare Drop도 같은 정적 ZIP을 받습니다. 계속 사용하는 Pages 프로젝트에서는 위의 **새 배포**로 기존 주소를 갱신하세요.

## Workers 프로젝트: rockman3d-workers-project.zip

ZIP을 **새 폴더**에 풀면 다음 배치입니다.

```text
wrangler.jsonc       Worker 이름과 public/ 정적 파일 경로
package.json         고정 Wrangler 개발·배포 명령
deploy.cmd           Windows 로그인·배포 실행
README.md            이 안내
public/
  index.html
  app/  assets/audio/  engine/  nes-toon-kit/  vendor/  docs/
```

Node.js **22.12.0 이상**이 필요합니다. 프로젝트 폴더의 CMD에서 실행합니다.

```bat
npm install
npm run deploy:check
npx wrangler login
npm run deploy
```

`deploy:check`는 **실제 게시 없이** 설정·정적 파일을 검사합니다. `deploy`가 실제 게시입니다. `deploy.cmd`는 위 설치·로그인·게시를 실행하는 수동 실행 도구입니다. 이 작업 중 Codex가 사용자 계정에 게시하거나 로그인한 것은 아닙니다.

`wrangler.jsonc`의 `name`은 기본 `rockman3d-emerald-run`입니다. 기존 Worker를 갱신하려면 해당 이름으로 변경하고 배포합니다. 새 Worker로 올리려면 별도의 이름을 쓰세요. 완료 후 Wrangler가 표시하는 HTTPS `workers.dev` 주소를 PC와 Quest 브라우저에서 엽니다.

다른 프로젝트로 ZIP을 옮겨도 동작하며 `F:\testgame` 원본 경로나 별도 음원 폴더가 필요하지 않습니다. `public/`은 이미 빌드된 결과라 엔진 컴파일·음원 변환 없이 배포합니다. 소스에서 다시 만들 때는 루트 프로젝트의 `npm run build`를 사용합니다.

## 배포 설정

- **Workers Static Assets**로 제공합니다. KV/R2/DB/서버 함수/별도 게임 서버는 필요하지 않습니다.
- `assets.not_found_handling`은 `none`입니다. 누락된 JS/음원을 index.html로 잘못 돌려주지 않습니다.
- `_headers`에 XR 권한 정책과 MIME 보호를 포함합니다. Workers가 정적 파일 확장자에 맞는 Content-Type을 붙입니다.
- HTTPS가 VR 진입에 필요합니다. PC 모드에는 VR 기기가 필요하지 않습니다.
- 별도 Service Worker를 넣지 않아 업데이트 후 옛 코드·음원이 오프라인 캐시에 남지 않습니다.
- 배포용에는 IWER, QA 전역, 개발 인증서·개인 키, node_modules, 원본 NSF/ROM, 개발 서버를 넣지 않습니다.

음악과 효과음은 사용자가 기존 프로젝트에 정리해 둔 원작 Ogg를 복사한 것입니다. 출처·변환 정보·권리자 표기는 `public/assets/audio/manifest.json`, `provenance.json`과 `THIRD_PARTY_NOTICES.md`에 보존되어 있습니다. 이를 새로 작곡한 음악이나 자유 라이선스 음원이라고 표시하지 않습니다.

## 게시 후 확인

1. PC에서 **PC로 플레이** → WASD 이동, 마우스 조준, 왼쪽 클릭 발사, Space 점프, Shift/C 슬라이드, V 1·3인칭, Esc 쉬기.
2. 처음 사용자 입력 후 스테이지 BGM과 버스터 소리가 나오는지 확인합니다. M은 전체 음소거이며 타이틀 설정에서 음악·효과음 볼륨을 따로 조절합니다.
3. 보스에 접근하면 보스 BGM, 일시 정지에서는 메뉴 음악, 격파 후 클리어 징글·무기 획득 음악으로 전환되는지 확인합니다.
4. Quest에서는 양손 Touch로 VR에 진입합니다. 실제 Quest GPU FPS·발열 검사는 별도로 남아 있습니다.

공식 근거: [Static Assets 구성](https://developers.cloudflare.com/workers/static-assets/binding/), [배포 시작](https://developers.cloudflare.com/workers/static-assets/get-started/), [정적 헤더](https://developers.cloudflare.com/workers/static-assets/headers/).
