게임 빌드 업로드

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

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

• 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. 다음 명령을 실행하여 유틸리티를 초기화합니다.

build_loader.exe --init --api-key <api-key> --game-path <path-to-game>

build_loader.exe --init --api-key E51DPZ486S9IUGVF43AH4T48QB7246OQ --game-path C:\Games\LastGameBuild

./build_loader --init --api-key <api-key> --game-path <path-to-game>

./build_loader --init --api-key ZTXBI5EWCSWLH79FHAPE69TUF2F05V52 --game-path /Users/johndoe/Projects/xsolla-build-loader/game

서버에 게임 빌드 업로드

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

build_loader --update --game-path <path-to-game> --descr <build-description>

build_loader.exe --update --game-path C:\Games\LastGameBuild

./build_loader --update --game-path <path-to-game> --descr <build-description>

./build_loader --update --game-path /Users/johndoe/Projects/xsolla-build-loader/game

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

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

1. 관리자 페이지에서 프로젝트를 엽니다.
2. 사이드 메뉴에서 런처를 클릭합니다.
3. 게임 섹션에서 게임 오른쪽에 있는 설정을 클릭합니다.
4. 빌드 > 게임 빌드로 이동합니다.
5. 게임 빌드 테이블까지 아래로 스크롤합니다.

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

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

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

게임 파일 설정

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

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

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

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

game.exe --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en

game --xsolla-login-token eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJlbWFpbCI6InAudHVnb2x1a292QHhzb2xsYS5jb20iLCJleHAiOjE1ODU1MDYxMTMsImdyb3VwcyI6W10sImlhdCI6MTU4NDY0MjExMywiaXNzIjoiaHR0cHM6Ly9sb2dpbi54c29sbGEuY29tIiwicGFydG5lcl9kYXRhIjp7ImFkbWluIjp0cnVlfSwicGF5bG9hZCI6IiIsInByb21vX2VtYWlsX2FncmVlbWVudCI6dHJ1ZSwicHJvdmlkZXIiOiJ4c29sbGEiLCJyZWRpcmVjdF91cmwiOiIiLCJzdWIiOiIyNmYxNzI5Ni00Nzk5LTExZTgtOTBkMC00MjAxMGE4YTAwMTkiLCJ0eXBlIjoic29jaWFsIiwidXNlcm5hbWUiOiJzb21lX3VzZXJAbWFpbC5jb20iLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6Ikk2QTJrTEZPQ2JkcnUzamIxMjNyT3JmWnNkTnFpdVcxMjNpWTdKcW85OHI5b0hPbyIsInhzb2xsYV9sb2dpbl9wcm9qZWN0X2lkIjoiNDBkYjJlYTQtNWQ0Mi0xMWU2LWEzZmYtMDA1NDU2YTBlMTRhIn0.ZsTNiwY2iPp7HKqHs5g6JXzL2kv_RVuMNBlF-Tn2ccE --xsolla-locale en

튜토리얼

계속 읽기