Как добавить игру в клиентскую оболочку

Оболочка Gizmo Client — это красивая витрина, пока в ней нечего запускать. Ставить игры на клиентские пк вы, конечно, будете как обычно, через Steam, Epic или любой другой лаунчер — но чтобы гость видел их прямо в интерфейсе клуба и запускал одним кликом, каждую игру нужно добавить в Gizmo Manager как приложение. Разберём это на примере Steam-игры — с любым другим лаунчером принцип точно такой же.

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

→
и состоит из двух связанных, но разных сущностей: карточки приложения — то, что видит гость (иконка, название, категория), создаётся один раз, — и исполняемого файла внутри карточки — то, что реально запускается на клиентском пк (путь до игры и параметры запуска). Одной карточке можно назначить несколько исполняемых файлов — например, если игра установлена по разным путям на разных пк клуба (бывает, если образы клиентских пк собирали в разное время или разные люди). Так разделено специально: обложку и название не нужно настраивать заново для каждого пк, а путь запуска можно гибко подстроить под конкретные машины.

Шаг 1. Создайте карточку приложения

Перейдите в

→
→
и заполните:

  • Название — то, что видит гость в оболочке. Добавьте и обложку — за иконками и обложками для игр из Steam удобно ходить на steamgriddb.com, там уже готовы обложки почти для всего, что есть в Steam.

  • Группа по умолчанию и категория в разделе Организация приложений — определяют, куда приложение попадёт в оболочке и как его можно будет отфильтровать.

Сохраните карточку и откройте её заново — теперь в неё можно добавить исполняемый файл.

Если вы добавляете не одну-две игры, а весь каталог клуба (а это легко доходит до полусотни позиций), не пытайтесь сделать всё за один присест. Разбейте на категории заранее — шутеры, стратегии, спортивные симуляторы — ещё до того, как начнёте создавать карточки, и заполняйте группу по умолчанию сразу правильно. Переразбирать полсотни уже созданных приложений по категориям задним числом гораздо дольше, чем сделать это по ходу.

Шаг 2. Добавьте исполняемый файл

Нажмите + Создать исполняемый файл внутри карточки и заполните:

  • Подпись — название ярлыка, которое увидит гость, и иконка для него (тоже можно взять со steamgriddb.com).

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

  • Путь к исполняемому файлу — путь на клиентском пк (не на сервере), по которому запускается приложение. Рабочий каталог — папка, в которой лежит этот файл, без имени самого файла.

Как найти путь к игре, на примере Steam:

  1. Найдите ярлык на рабочем столе, нажмите правой кнопкой мыши → «Перейти к расположению файла».

  1. Откроется папка с игрой — скопируйте путь из адресной строки проводника, например C:\Program Files (x86)\Steam.

  1. В поле Путь к исполняемому файлу впишите этот путь, добавив в конце название запускаемого файла: C:\Program Files (x86)\Steam\steam.exe. В поле Рабочий каталог впишите сам путь к папке, без имени файла: C:\Program Files (x86)\Steam.

Чтобы из оболочки сразу запускалась конкретная игра, а не только сам лаунчер, укажите в поле Аргументы команду запуска игры — например, steam://rungameid/730 для Counter-Strike 2. Пути и аргументы для Steam, Epic, Riot, Ubisoft, VK Play, Battle.net, приложений из Microsoft Store и системных программ — в справочнике «Пути и аргументы запуска для лаунчеров и приложений».

Шаг 3. Настройте параметры запуска

В разделе Организация параметров запуска рекомендуем включить Auto Launch и Monitor Children — для подавляющего большинства игр этого достаточно, чтобы всё работало гладко.

  • Auto Launch — запускает приложение сразу после предварительных действий (развёртывания, задач). Если выключено, гостю придётся нажать запуск дважды: первый раз — чтобы выполнить предварительные действия, второй — чтобы подтвердить запуск. Это не автозапуск приложения при включении пк.

  • Monitor Children — позволяет Gizmo Client отслеживать дочерние процессы, запущенные приложением (например, отдельные лаунчеры или античит-модули), а не только сам исполняемый файл.

Сохраните настройки — приложение готово.

Шаг 4. Проверьте, что приложение появилось у гостя

Приложение появится в оболочке на всех клиентских пк, где оно установлено по указанному пути. Если путь не совпадает хотя бы на одном пк — ярлык там не будет отображаться. Первым делом при проблемах проверяйте именно совпадение пути установки игры с путём, указанным в исполняемом файле — это причина девяти проблем из десяти.

Результат

Игра отображается в оболочке Gizmo Client на всех клиентских пк, где она установлена по указанному пути, — гость видит её прямо в интерфейсе клуба и запускает одним кликом.

Если игра запускается с клубных аккаунтов лаунчера, подключите их по инструкции «Как настроить клубные аккаунты в лаунчерах».