Лаунчер / Загрузка сборки игры

Загрузка сборки игры

Для загрузки сборки игры на сервер обновлений используется консольная утилита Build Loader.

Системные требования для Build Loader:

  • Операционная система: Windows 7/8/10 64-bit, macOS 10.14.0 и выше
  • Процессор (CPU): 1.6 ГГц
  • Свободный объем оперативной памяти (RAM): 100 Мб (или более)
  • Свободный объем жесткого диска: 150% от размера файла сборки игры

Build Loader принимает следующие флаги:

  • --init — инициализация утилиты.
  • --update — отправка сборки игры на сервер.
  • --builds-list — список сборок игры.
  • --descr <build-description> — описание сборки.
  • --api-key <API-key> — ключ API.
  • --game-path <path-to-game>  — путь к сборке игры.
  • --chunk-size <chunk-size> — размер чанков — частей, на которые разбивается архив игры. Измеряется в Мб или Гб. Флаг принимает значение от 10mb до 5120mb или от 1gb до 5gb, по умолчанию 5gb.
  • --retry-timeout <timeout> — интервал между попытками загрузки файлов, измеряется в секундах. Флаг принимает значение от 10 до 60, по умолчанию 20.
  • --retry-count <retry-count> — количество попыток загрузки файлов. Флаг принимает значение от 1 до 10, по умолчанию 3.

Чтобы загрузить сборку игры:

  1. Перейдите в раздел Настройки сборок в Личном кабинете.
  2. Скопируйте ключ API.
  3. Скачайте и установите Build Loader.
  4. Инициализируйте утилиту.
  5. Загрузите сборку игры на сервер.
  6. Разместите сборку игры на stage.
  7. Настройте файлы игры.

Инициализация Build Loader

Для инициализации утилиты передайте ранее скопированный ключ API и путь к сборке игры:

Note
  • Повторная инициализация параметров требуется в случае изменения их значений.
  • Путь к сборке игры может содержать только только латинские буквы.

Загрузка на сервер

Для загрузки сборки игры на сервер укажите путь к сборке:

Если параметр --game-path уже использовался при инициализации или предыдущей загрузке сборки, его можно опустить. При первой загрузке сервер обновлений получает всю сборку игры, при следующих — патчи, сформированные Build Loader.

Размещение на stage

Сборки игры, загруженные на сервер, отображаются в Личном кабинете в разделе Настройки проектов > Настройки сборок > Список сборок. Выберите stage для размещения сборки игры:
  • master: игра будет доступна конечным пользователям;
  • test: игра будет доступна только для тестирования.
Note
Для тестирования игры запустите лаунчер с параметром -game_stage test в консоли. Например: launcher.exe -game_stage test.

Настройка файлов игры

Для корректной загрузки игр из лаунчера необходимо настроить и инициализировать файлы загрузки.
  1. В Личном кабинете в разделе Настройки сборок перейдите к блоку Настройки файлов игры.
  2. Введите название и расширение файла, который запускает игру (например, coolgame.exe).
  3. Укажите путь установки игры.
  4. Загрузите распространяемые файлы, необходимые для запуска игры (например, Microsoft Visual C++ 2017 Redistributable).
Лаунчер передает игре следующие параметры:
  • --xsolla-locale <locale>: язык интерфейса;
  • --xsolla-login-token <token>: Xsolla Login JWT (JSON Web Token).
ПРИМЕР

Туториалы

Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Оценить страницу
Оценить страницу
Что может сделать страницу еще лучше?

В другой раз

Спасибо за обратную связь!
Последнее обновление: 25 июня 2021

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!