Crossplay Launcher Patch File Maker

Crossplay Launcer Patch File Maker는 게임 풀 클라이어트의 최신 버전과 직전 버전을 비교한 패치 파일들을 Patch_Files_Folder에 생성합니다.

항목 argument
이전 버전 게임 파일 경로 Previous Version Path의 Select Path 클릭하여 경로 선택
(meta.json 및 게임 파일 포함 폴더)

meta.json 파일에 관한 내용은 크로스플레이 런처 가이드의 주의 사항 > 게임 관련 주의 사항을 참고하세요.
신규 버전 게임 파일 경로 Current Version File Path의 Select Path 클릭하여 경로 선택
(meta.json 및 게임 파일 포함 폴더)

meta.json 파일에 관한 내용은 크로스플레이 런처 가이드의 주의 사항 > 게임 관련 주의 사항을 참고하세요.
Patch 파일 생성 경로 Patch File Path의 Select Path 클릭하여 경로 선택
버전 설정 Previous Version 란에 입력
appid 설정 Appid 란에 입력
환경 DEV Environment 목록에서 combobox 선택
TEST
SANDBOX
LIVE

적용 예시

앱 아이디가 com.gcp2.stepbystep.windows.google.global.normal이고 2021.12.12.0001 버전이 업로드된 조건에서 2021.12.12.0002 버전을 업로드하는 경우 다음의 이미지와 같이 각 항목을 채워 패치 파일을 생성합니다.

Crossplay Launcher Uploader

크로스플레이 런처를 통해 사용자들이 게임 파일을 다운로드할 수 있도록 게임 개발 파트에서 게임 파일을 제작 및 QA 완료 후 서버에 업로드해야 합니다. Crossplay Launcher Uploader를 이용하여 게임 파일을 업로드할 수 있습니다

항목 argument
업로드 파일 경로 설정 Upload Folder Path의 Browse 클릭하여 경로 선택
Patch 파일 생성 경로 Patch Folder Path의 Browse 클릭하여 경로 선택
(최초 업로드가 아닌 경우, Not first time upload 선택 후 경로 선택)
업로드 환경 DEV Upload Environment 목록에서 combobox 선택
TEST
SANDBOX
LIVE
플랫폼 설정 Target Platform 목록에서 combobox 선택
Release 설정

Is Release 목록에서 combobox 선택

게임 버전은 릴리즈 버전과 패치 버전으로 구분됩니다. 최신 버전과 이전 버전 간 변경점이 크지 않다면 가급적 패치 버전을 사용하세요.

  • 릴리즈 버전(Y): 서버에 원본 파일과 패치 파일이 모두 업로드되며, 최초 설치 시 최신 릴리즈 버전 게임이 다운로드됩니다.
  • 패치 버전(N): 서버에 패치 파일만 업로드됩니다. 최신 릴리즈 버전을 설치한 사용자는 이후 패치 버전을 사용하여 게임을 패치할 수 있습니다.
appid 설정 Appid 란에 입력
버전 설정 Game Version 란에 입력

업로드 절차

업로드 전 준비

  1. Hive 콘솔 > 크로스플레이 런처 > 게임 관리 > 업로드 IP 관리 메뉴에서 게임과 앱아이디를 선택하고 업로드할 PC의 IP 주소를 등록합니다.

  2. 게임 파일을 업로드합니다. 게시 버전에 관계없이 항상 게임 원본 파일은 Upload Folder Path에 넣고, 패치 파일은 Patch File Path에 넣어야 합니다.

  3. meta.json 파일을 제작하여 Upload Folder Path에 넣습니다. meta.json 파일에는 게임 바로가기 아이콘 파일의 상대 경로와 게임 실행 파일의 상대 경로 정보가 있어야 합니다. 게임 바로가기 파일은 게임 개발 전에 미리 제작해야 하며, Windows에서만 사용하기 때문에 Mac 버전 게임에서 icon 필드는 생략할 수 있습니다. 예) {“launch”:”game/game.exe”, “icon”:”game/icon.ico”} (field명 고정: launch 및 icon)

툴로 업로드 처리

성공 시 Status Code : 201 노출됩니다.

업로드 완료 후 체크

  1. 게임 업로드가 완료되면 http://console.withhive.com/에 접속하여 정상적으로 업로드되었는지 확인하세요.
    • TEST 환경: http://test-console.withhive.com/
    • SANDBOX 환경: http://sandbox-console.withhive.com/
  2. 검수 상태에서 릴리즈 버전은 아래 모든 항목을, 패치 버전은 검수 IP 등록과 게임 업데이트 확인하기 항목을 반드시 확인해야 합니다.
    1. 검수 IP 등록 (미등록 시)

      게임명과 appid를 선택하여 공인 IP(권장) 또는 사설 IP를 등록하세요.

    2. 게임 업데이트 확인하기 (릴리즈 버전과 패치 버전 모두 필요)
      • 직전 버전까지 설치 또는 업데이트를 진행하고, 검수할 버전을 대기 상태에서 검수 상태로 변경한 후 게임 업데이트를 실시하세요.
      • 게임 업데이트 중 크로스플레이 런처의 오류 발생 여부를 확인하세요.
      • 게임 시작 시 정상 작동 여부를 확인하세요.
      • WinMerge와 같은 데이터 비교 툴을 사용하여 로컬 크로스플레이 런처로 설치된 게임 풀 클라이언트와 게임 개발단에서 갖고 있는 검수 중인 버전의 오리지널 풀 클라이언트를 비교하세요. 파일이 동일해야 합니다.
        게임 검수 설정
    3. 게임 설치 확인하기 (릴리즈 버전에서만 필요)
      1. Windows 환경에서는 제어판에서 게임을 제거하세요.
      2. 업로드한 게임을 설치하세요.
        • 게임 설치 중 크로스플레이 런처의 오류 발생 여부를 확인하세요.
        • 바탕화면\시작 메뉴에 아이콘이 생성되었는지 확인하세요.
        • 게임 시작 시 정상 작동 여부를 확인하세요.
        • WinMerge와 같은 데이터 비교 툴을 사용하여 로컬 크로스플레이 런처로 설치된 게임 풀 클라이언트와 게임 개발단에서 갖고 있는 검수 중인 버전의 오리지널 풀 클라이언트를 비교하세요. 파일이 동일해야 합니다.
      3. 검수 상태에서 제어판에 진입하여 게임을 삭제하고, 추가로 파일을 삭제하는 delete 파라미터와 바탕화면 및 시작 메뉴 바로가기가 정상적으로 삭제되었는지 확인하세요. delete 파라미터에 대한 내용은 크로스플레이 런처 > 게임 관련 주의 사항 > 파일 삭제 기능 가이드를 참고하세요.

배포

  1. 검수 설정을 OFF 상태로 변경하고, 배포 설정 창에서 배포일을 지정한 후 배포일 저장을 클릭하세요.
  2. 상태 항목이 배포중으로 변경되었는지 확인하세요.
    • 배포 전
    • 배포 후