Частые вопросы

Общие вопросы

Зачем мне использовать Xsolla Launcher, если я могу создать собственный лаунчер?

Использование Xsolla Launcher поможет сэкономить вам ресурсы и время на финальной стадии разработки или после завершения разработки игры. Xsolla Launcher бесплатный для партнера, за исключением комиссий за платежи. Xsolla Launcher регулярно выпускает новые возможности для пользователей и работает с другими продуктами Xsolla: In-Game Store, Site Builder, Login и другие. Xsolla следит за трендами на рынке и следует им.

Сколько стоит Xsolla Launcher?

Стоимость доступа к Xsolla Launcher уже включена в комиссию Xsolla. Дополнительные расходы возможны при доставке игр. Однако за счет использования системы балансирования P2P расходы на доставку снижаются в среднем на 80%.

Как доставлять обновления игры в Steam, если я использую Xsolla Launcher?

Если вы используете лаунчер Steam, вы загружаете сборку игры и лаунчер напрямую в Steam. В этом случае Steam доставляет и обновляет игру. Если вы хотите доставлять контент средствами Xsolla Launcher и его CDN в Steam, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

Нужно ли мне поддерживать две разные сборки игры: не привязанную к платформе и для Steam?

Количество сборок зависит от способа интеграции со Steam. Однако чаще всего одной сборки достаточно. Если вы поддерживаете доставку игры с помощью нескольких платформ, лаунчер позволит собрать данные пользователей в единую базу. Также лаунчер поддерживает сквозную регистрацию: если пользователь запускает игру через Steam впервые, он не должен вводить свои данные.

При этом пользователь может перейти на ваш сайт вне системы Steam. Он может аутентифицироваться, используя свой Steam OpenID, и стать членом вашего официального сообщества. После этого пользователь сможет писать на форумах, читать новости, находить новые игры и т. д.

Я пользуюсь инструментами Steam, в том числе их лаунчером, и не беспокоюсь о расходах на CDN. Что изменится, если я начну использовать Xsolla Launcher?

Добавляя Xsolla Launcher в Steam вместе с игрой, вы не меняете логику дистрибуции, Steam по-прежнему отвечает за распространение и обновление игр. CDN лаунчера в данном случае не используется.

Если вы хотите распространять игру самостоятельно и используете лаунчер независимо от платформ, Xsolla Launcher распределяет сборки и обновления игр, используя свой CDN (G-core по умолчанию) или любой другой по вашему запросу. Оплата трафика не входит в стандартную комиссию платежей и оплачивается отдельно по чекам ежемесячно.

Xsolla имеет специальную корпоративную цену на G-core, которая распространяется на всех ее клиентов.

Есть ли у вас список CDN, которые интегрированы в ваш Xsolla Launcher? Нужно ли мне обращаться к компаниям, предоставляющим CDN, для дальнейшей интеграции? Могу ли я использовать CDN, которого нет в вашем списке?

Если вы хотите использовать другой CDN провайдер, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

Какие игры отображаются в списке игр в Xsolla Launcher? Все добавленные игры или только те, которые купил пользователь?

В списке отображаются все добавленные игры. Для купленных игр доступна кнопка Играть, для остальных — Купить.

Можно ли выдавать конкретным пользователям бесплатные игровые ключи? Как они смогут ими воспользоваться?

Да. Выгрузите игровые ключи из Личного кабинета и разошлите любым удобным для вас способом. Пользователи смогут активировать ключи в лаунчере.

Могу ли я настроить автоматическую аутентификацию пользователей в игре при входе в лаунчер?

Да, такая настройка возможна. Для передачи данных пользователей из Xsolla Launcher в игру используется параметр –xsolla-login-token. Чтобы получить данные пользователей, необходимо декодировать значение параметра.

Что я могу сделать, если иконка Xsolla Launcher не изменилась после того, как я ее изменил и пересобрал лаунчер?

Переустановите Xsolla Launcher.

Где я могу посмотреть логи лаунчера?

Чтобы посмотреть логи лаунчера:

1. Откройте лаунчер.
2. Перейдите в настройки лаунчера.
3. В разделе Общие нажмите Открыть лог-файлы.

Как я могу добавить игру в Xsolla Launcher?

Чтобы интегрировать игру с лаунчером, достаточно создать проект в Личном кабинете и загрузить сборку игры. После этого добавьте изображения для своей игры и настройте дополнительные параметры в интерфейсе (опционально).

Есть ли в SDK межпроцессное взаимодействие (IPC)?

Сейчас нет, так как в Launcher нет функций, для которых оно требуется. По мере добавления новых функций, таких как онлайн-стриминг и игровой магазин в режиме overlay, будет добавлено и необходимое для них IPC-взаимодействие.

Поддерживается ли Xsolla Launcher на мобильных устройствах или Mac? 

Xsolla Launcher поддерживает операционные системы Windows и MacOS.

Как я могу заполнить контент на странице игры в Xsolla Launcher? 

Вы можете заполнить информацию для контента в настройках каждой игры в разделе Game info. Также вы можете заполнить контент для страницы игры в разделе Game titles в Xsolla Launcher. Чтобы узнать больше, прочитайте инструкцию.

Build Loader

Когда я загружаю патч игры через Build Loader, возникает ошибка: “Attention! File path longer than 260 symbols.”. Как это исправить?

В Windows существует ограничение на максимальную длину полного пути, поэтому мы рекомендуем вам перенести директорию с игрой выше в дереве каталогов, например C:/Patch. После этого передайте обновленный путь к сборке игры с помощью команды –game-path <path-to-game>. Чтобы узнать больше, прочитайте инструкцию.

У меня не запускается Build Loader. Как это исправить?

BuildLoader — это утилита командной строки. Откройте интерпретатор командной строки, например cmd.exe, в директории с файлом build_loader.exe и запустите файл с помощью следующей команды: ./build_loader.exe. Чтобы узнать больше, прочитайте инструкцию.

Неизвестная проблема с Build Loader. Как это исправить? 

Свяжитесь с командой интеграции Xsolla через чат в правом нижнем углу в Личном кабинете и предоставьте файл log.txt, который находится в той же директории, что и файл build_loader.exe.

Личный кабинет

Когда я вхожу в Личный кабинет, он показывает, что я использую старую версию Launcher и должен создать новый лаунчер, но когда я нажимаю Try New Launcher, отображается действующий лаунчер. Как это исправить?

На данный момент Личный кабинет позволяет работать с лаунчером версий v2.x.x и v3.x.x, но создание лаунчера v2.x.x более недоступно. Когда вы переключаетесь на новую версию Launcher, настройки сохраняются на вашем устройстве, но если вы войдете с нового устройства, то будут применены настройки как для пользователя старой версии Launcher.

Созданные лаунчеры не отображаются в разделе Launcher в Личном кабинете. Как это исправить?

Удалите данные и файлы сookie сайта Личного кабинета в настройках браузера.

Я не могу изменить никакие настройки в Личном кабинете. Как это исправить? 

Убедитесь, что вам назначена роль разработчика или хозяина, пользователи остальных ролей не имеют прав для изменения настроек.

Я изменил роль в Личном кабинете, но не получил права для изменения настроек. Как это исправить?

Чтобы обновить настройки прав, выполните повторный вход в Личный кабинет.

Генерация лаунчера остановилась. Как это исправить?

Свяжитесь с командой интеграции Xsolla через чат в правом нижнем углу в Личном кабинете.

Как я могу быстро увидеть изменения, которые я сделал в Xsolla Launcher? 

Вы можете сгенерировать черновик Xsolla Launcher. Все изменения настроек и кастомизации, которые вы сохраните в Личном кабинете, автоматически применяются в черновике.

Как я могу распространять свою бесплатную игру с микротранзакциями через Xsolla Launcher?

Чтобы распространять бесплатную игру:

1. Перейдите в ваш проект в Личном кабинете.
2.  В боковом меню нажмите Launcher.
3. В карточке нужного проекта нажмите Редактировать.
4. В разделе Игры нажмите Настроить.
5. Нажмите Распространение и выберите Free-to-play.
6. В верхнем меню нажмите Магазин и установите переключатель Показывать магазин в лаунчере в положение Вкл.

После того, как вы выполнили эти шаги, для игры в лаунчере должна появиться вкладка Магазин. Чтобы узнать больше, прочитайте инструкцию.

Кастомизация

Плагин Figma tokens не работает корректно. Как это исправить? 

Откройте настройки плагина Figma tokens и включите хранение данных в локальном документе.

Что я могу изменять через Figma?

Figma позволяет настраивать следующие элементы:

• скругление и цвет кнопок;
• цвет шрифта;
• скругление и цвет окон;
• скругление и цвет плиток контента;
• скругление и цвет полей для ввода данных;
• цвет панелей.

Изображения даны только для предпросмотра и изменяются в настройках в Личном кабинете. Другие настройки, такие как расположение элементов и размер изображений изменить нельзя.

Могу ли я скачать исходный код Launcher и внести необходимые изменения в него вместо настройки через Личный кабинет?

В данный момент, мы не предоставляем исходный код лаунчера и вы можете его настраивать только через Личный кабинет и Figma.

Я хочу отключить аутентификацию пользователей в лаунчере. Как я могу это сделать?

Эта функциональность станет доступна в Личном кабинете после подписания договора.

Я не могу изменить название лаунчера. Как это исправить?

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

Как я могу изменить порядок отображения игр в лаунчере?

В данный момент эта функциональность недоступна.

Могу ли я переместить кнопку Скачать в другое место?

В данный момент элементы интерфейса нельзя перемещать, но вы можете настраивать их цвет и скругление с помощью Figma и загружать настройки в Личном кабинете.

Установщик

Должен ли я разместить ссылку на скачивание лаунчера на своем сайте? Могу ли я реализовать регистрацию пользователей через лаунчер вместо сайта?

Да, это является главным каналом распространения лаунчера для большинства наших партнеров. Однако не забудьте обновлять ссылку на скачивание лаунчера при каждой его генерации. Регистрация пользователей через лаунчер также доступна.

Могу ли я добавить ссылку на скачивание лаунчера в письмо для подтверждения регистрации?

Нет, эта возможность недоступна, поскольку ссылка для скачивания лаунчера меняется при каждой генерации лаунчера.

Как я могу изменить название установочного файла?

Чтобы изменить название установочного файла, воспользуйтесь инструкцией.

Могу ли я получать информацию о том, установлен ли лаунчер у пользователя?

Как я могу изменить название установочного файла?

Установка лаунчера завершается неудачно при запуске автономного установщика веб-установщиком. Как это исправить?

Наиболее распространенные способы решения этой проблемы:

• Попробуйте изменить директорию установки.
• Попробуйте установить лаунчер на другой диск.
• Отключите антивирус, перезагрузите компьютер и попробуйте установить лаунчер.
• Попробуйте установить лаунчер с помощью оффлайн-установщика.

Как я могу получить автономный установщик? 

1. Откройте страницу Cборки лаунчера в Личном кабинете.
2. Выберите черновик или опубликованную сборку.
3. Нажмите Получить ссылку на автономный установщик.

Получаю ошибку “Your internet connection seems to be not permitted or dropped out”. Как это исправить?

Попробуйте отключить антивирус и брандмауэр, перезагрузить компьютер и повторить попытку.

Запуск игр

Должен ли лаунчер быть запущен на протяжении всей игры?

По умолчанию — да. После запуска игры лаунчер сворачивается в область уведомлений и не использует ресурсы компьютера. В процессе игры связи между ней и лаунчером нет, поэтому пользователь может завершить работу лаунчера самостоятельно.

Можно ли настроить P2P-соединение для компьютеров в одной локальной сети, чтобы данные передавались только внутри нее?

На данный момент такая возможность недоступна.

Есть ли способ передать информацию для входа в игру при запуске игры пользователем в лаунчере?

Да, лаунчер передает JWT в аргументе командной строки.

В настоящее время каждая игра может иметь только одну сборку лаунчера. Вы можете использовать другую сборку игры для черновой версии лаунчера, но она не может быть распространена среди конечных пользователей.

В настоящее время каждая игра может иметь только одну сборку лаунчера. Вы можете использовать другую сборку игры для черновой версии лаунчера, но она не может быть распространена среди конечных пользователей.

Антивирус показывает предупреждающее окно или блокирует загрузку игры. Как это исправить?

Это ложно-положительная реакция антивируса на загрузку через P2P (peer-to-peer). Лаунчер использует соединения P2P для загрузки игровых файлов, поэтому он подключается к пользователям по общему публичному IP-адресу, который используется несколькими пользователями или сайтами.
Если вы используете программу Malawarebytes, изучите официальный комментарий по этому поводу.
Чтобы исправить ошибку, пользователь должен перейти в настройки лаунчера и отключить опцию Использовать сеть P2P (peer-to-peer).

Поддерживаете ли вы запуск браузерных игр через лаунчер?

Да, для настройки запуска браузерных игр, прочитайте инструкцию.

Поддерживаете ли вы запуск браузерных игр через лаунчер?

В данный момент наша система не поддерживает эту функциональность. Вы можете создать скрипт, который будет запускать игру с необходимыми аргументами, и указать этот скрипт в качестве исполняемого файла в Личном кабинете.

При запуске игры в лаунчере я получаю ошибку "Отсутствуют или повреждены игровые файлы". Как это исправить?

1. Убедитесь, что исполняемый файл указан в Личном кабинете.
2. Проверьте исполняемый файл: убедитесь, что имя и относительный путь к исполняемому файлу указаны правильно.
3. Убедитесь, что вы используете черновую сборку лаунчера для просмотра изменений в реальном времени. Если вы используете опубликованную сборку лаунчера, убедитесь, что была создана и опубликована новая версия.

Могу ли я предоставить бесплатный ключ игрокам, которые уже имеют игру на других платформах (например Steam, Epic) для переноса на платформу Xsolla?

Вы можете взять любое количество игровых ключей из раздела Store в Личном кабинете и отправить их пользователям вручную по электронной почте. Пользователи смогут активировать эти ключи в лаунчере.

Могу ли я загрузить SFX-архив в качестве распространяемого файла?

Да, если SFX-архив упакован в виде исполняемого EXE-файла.

Когда устанавливается распространяемый файл?

Распространяемые файлы устанавливаются только во время установки игры. При обновлении или восстановлении игры распространяемые файлы не переустанавливаются.

Есть ли возможность добавить достижения в лаунчер?

В настоящее время в лаунчере нет функции достижений. Свяжитесь с нами, если у вас есть запрос на эту функциональность.

Поддерживает ли магазин лаунчера купоны?

В данный момент мы поддерживаем только промокоды в корзине магазина.

Могу ли я продавать подписки через лаунчер?

В данный момент лаунчер не поддерживает продажу подписок. Свяжитесь с нами, если у вас есть запрос на эту функциональность.

Поддерживает ли лаунчер модификации для игр?

Поддерживает ли лаунчер модификации для игр?

Миграция с Launcher v 2.x на Launcher v 3.x

Могу ли я создать запрос на новую функциональность для Launcher 2.x?

В данный момент мы принимаем запросы на новые функциональности только для Launcher 3.x в настоящее время.

Могу ли я скачать лаунчер с GitHub и настроить его через конфигурационные файлы?

GitHub использовался только для Launcher версии 2.x. Для Launcher версии 3.x все настройки доступны в Личном кабинете.

Автоматически ли новости из Launcher 2.x переносятся на плитки контента в Launcher 3.x?

На данный момент в Launcher нет такой функциональности. Это две отдельные системы новостей.

Вкладки

Пользователи получают ошибку "Попробуйте еще раз" при открытии вкладки в лаунчере. Как это исправить?

Возможная причина: ваш веб-сайт возвращает заголовок x-frame-options: SAMEORIGIN, который блокирует отображение сайта в лаунчере. Удалите заголовок x-frame-options и добавьте заголовок Content-Security-Policy: frame-ancestors file://*.

Владение игрой и игровые ключи

Как мои пользователи могут получить доступ к играм? Можно ли распространять игры по подписке, купону или промокоду?

На данный момент доступ к играм предоставляется только по игровым ключам. Подписки появятся в Xsolla Launcher в 2024 году.

Могут ли пользователи Xsolla Launcher загружать обновления игры, если они не приобрели игровые ключи?

Нет. Игры и обновления игр недоступны без приобретения ключей игры. Если у вас есть бесплатные игры, это возможно.

Что будет с доступом пользователя к игре, если он сделал возврат платежа?

Пользователь потеряет доступ к игре. Он сможет снова купить игру через Xsolla Launcher, нажав кнопку Купить.Последнее обновление: 21 февраля 2024