게임 빌드 업로드

게임 빌드를 업데이트 서버로 로딩하려면 빌드 로더 명령줄 유틸리티를 사용합니다.

빌드 로더 시스템 요구 사항:

  • Windows 10 64 비트 OS 또는 macOS 12.4.0 이상
  • 1.6 GHz CPU
  • 100MB 여유 RAM
  • 여유 디스크 공간: 게임 빌드 크기의 1.5배

빌드 로더 수용 옵션:

  • –init - 유틸리티 초기화.
  • –update - 게임 빌드를 서버로 전송.
  • –builds-list - 게임 빌드 목록.
  • –descr <build-description> - 빌드 설명.
  • –api-key <API-key> - API 키.
  • –game-path <path-to-game> - 게임 빌드 경로.
  • –chunk-size <chunk-size> - 청크 크기 - 게임 아카이브가 분할된 파트.10mb에서 500mb의 값 수용, 기본값은 500mb.
  • –retry-timeout <timeout> - 파일 업로드 시도 사이의 타임아웃 시간(초). 10에서 60로의 값 수용, 기본값은 20.
  • –retry-count <retry-count> - 파일 업로드 시도 횟수. 1에서 10로의 값 수용, 기본값은 3.
  • –set-build-on-test - 게임 빌드를 테스트 스테이지에 배치. 게임은 테스트용으로만 가능합니다.
  • –set-build-on-master - 게임 빌드를 마스터 스테이지로 배치. 최종 사용자가 게임 사용 가능. 만약 –set-build-on-test이 명시된 경우, 옵션은 무시됩니다.
  • -no-progressbar - 진행 상태 바 비활성화.

게임 빌드 업로딩 방법:

  1. 관리자 페이지 > 빌드 설정으로 이동합니다.
  2. API 키를 복사합니다.
  3. 빌드 로더를 다운로드하고 설치합니다.
  4. 유틸리티를 초기화합니다.
  5. 서버에 게임 빌드를 업로드합니다.
  6. 게임 빌드를 스테이지에 배치합니다.
  7. 게임 파일을 설정합니다.

빌드 로더 다운로드 및 설치

빌드 로더 다운로드 및 설치 방법:

  1. 게임 섹션에서 게임 오른쪽에 있는 설정을 클릭합니다.
  2. 빌드 > 게임 빌드로 이동합니다.
  3. 운영 체제에 맞는 BuildLoader.zip을 클릭하여 빌드 로더로 아카이브를 다운로드합니다.
  4. 아카이브를 추출합니다.

아카이브의 압축을 해제한 폴더에 대한 상대적인 유틸리티 위치:

  • Windows의 경우: Win\build_loader.exe
  • MacOS의 경우: Mac/build_loader

빌드 로더 초기화

빌드 로더 초기화 방법:

  1. 게임 섹션에서 게임의 오른쪽에 있는 설정을 클릭합니다.
  2. 빌드 > 게임 빌드 섹션으로 이동합니다.
  3. API 키(런처 ID)에서 + 아이콘을 클릭하여 API 키를 복사합니다. 이 키를 사용하면 빌드 로더가 게임을 서버에 업로드할 수 있습니다.
  4. 다음 명령을 실행하여 유틸리티를 초기화합니다.

서버에 게임 빌드 업로드

게임 빌드를 서버로 업로드하려면 다음 명령을 실행합니다.

유틸리티를 초기화하거나 이전 빌드를 업로드할 때 이미 사용한 경우에는 다음 –game-path 매개변수를 생략할 수 있습니다.

처음 업로딩할 때 업데이트 서버가 전체 게임 빌드를 수신합니다. 그 이후에는 게임 패치(빌드 로더에 의해 생성)를 수신합니다.

알림
업로드한 빌더를 구분할 수 있도록 –descr 매개변수를 지정하는 것이 좋습니다.
게임 빌드를 보는 방법:
  1. 관리자 페이지에서 프로젝트를 엽니다.
  2. 사이드 메뉴에서 런처를 클릭합니다.
  3. 게임 섹션에서 게임 오른쪽에 있는 설정을 클릭합니다.
  4. 빌드 > 게임 빌드로 이동합니다.
  5. 게임 빌드 테이블까지 아래로 스크롤합니다.
알림
게임 빌드에 설정, 사용자 프로필 또는 저장 파일과 같이 게임 플레이 중에 변경되는 파일이 포함되어 있는 경우 이러한 파일을 무시된 파일 목록에 추가합니다. 그렇지 않으면 런처가 게임을 업데이트할 때 파일 무결성 위반을 감지하고 전체 게임을 다시 다운로드합니다.

게임 빌드를 스테이지에 배치

다음과 같이 게임 빌드를 스테이지에 배치할 수 있습니다.

  • 빌드를 서버에 업로드할 때 --set-build-on-master 또는 --set-build-on-test 중에 적절한 옵션을 빌드 로더에 전달합니다.
  • 빌드를 서버에 업로드한 후 런처 프로젝트에서 다음을 수행합니다.
    1. 게임에서 게임 오른쪽에 있는 설정을 클릭합니다.
    2. 빌드 > 게임 빌드로 이동합니다.
    3. 게임 빌드 테이블 아래로 스크롤합니다.
    4. 게임 빌드 테이블에서 필요한 빌드의 오른쪽에 있는 펜 아이콘을 클릭합니다.
    5. 마스터로 설정을 클릭하여 게임 빌드를 마스터 스테이지에 배치하거나 테스트 스테이지의 경우 스테이징으로 설정을 클릭합니다. 마스터 스테이지에 추가하면 게임 빌드가 런처의 게시된 빌드에 추가됩니다. 테스트 단계에 추가하면 게임 빌드가 런처의 초안 빌드에 추가됩니다.
    6. 선택 항목을 확인합니다.
    7. 닫기를 클릭합니다.
    8. 게임 빌드 테이블의 브랜치 열에 적절한 브랜치 이름이 표시됩니다. 또한, 빌드가 브랜치 테이블에 표시됩니다.
알림
게임을 테스트하려면 콘솔에 전달된 -game_stage test 매개변수로 런처를 시작하세요. 예: launcher.exe -game_stage test.

게임 파일 설정

런처가 사용자에게 올바른 파일을 보내도록 하려면 다음과 같이 먼저 런처 프로젝트에서 설치 파일을 설정하고 초기화합니다.

  1. 게임에서 게임 오른쪽에 있는 설정을 클릭합니다.
  2. 실행할 수 있는 파일 탭으로 이동합니다.
  3. 각 운영 체제에 대해 게임을 실행하는 파일의 이름과 확장자를 입력합니다. 예시: game.exe
  4. 게임에 재배포할 수 있는 파일이 있는 경우:
    1. 재배포 가능 탭으로 이동한 후 업로드를 클릭합니다.
    2. 표시되는 창에서:
      1. 파일 이름을 입력합니다.
      2. 파일 업로드 를 클릭한 후 실행할 수 있는 파일을 선택합니다.
      3. 업로드를 클릭합니다.

런처가 게임에 다음 매개변수를 전송함:

  • –xsolla-locale <locale>: 인터페이스 언어;
  • –xsolla-login-token <token>: 엑솔라 로그인 JWT (JSON 웹 토큰).
예제

튜토리얼

진행률
의견을 보내 주셔서 감사드립니다!

계속 읽기

다음 단계

설치 프로그램 생성
마지막 업데이트: 2024년 1월 22일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!