Промо-игры
Промо-игра хранит набор игровых наград и правила их случайного выбора. Она подходит для приветственного розыгрыша при регистрации, отдельной промостраницы, события в лаунчере или другого подключённого сценария. За один запуск игрок получает по одной награде из каждой настроенной группы.
Промо-игра открывается на отдельной публичной странице кампании и не добавляет лишний пункт в меню кабинета. Эту же кампанию можно открыть из новости, лаунчера или игрового события.
Чем промо-игра отличается от кейсов и колеса
| Механика | Кто запускает | Что видит игрок | VIP-попытки |
|---|---|---|---|
| Кейсы | Игрок открывает выбранный кейс | Страницу кейса, цену, возможные награды и результат | Отдельный лимит попыток кейсов |
| Колесо удачи | Игрок нажимает кнопку вращения | Колесо, цену, результат и историю выигрышей | Отдельный лимит попыток колеса |
| Промо-игра | Новый игрок на странице кампании | Условия, группы и шансы наград, затем предметы на складе | Не использует попытки кейсов или колеса |
Преимущество VIP Дополнительные попытки колеса и кейсов не запускает промо-игру. Оно только позволяет выполнить настроенное количество платных открытий кейсов или вращений колеса без списания баланса. Расход попытки кейса не уменьшает число попыток колеса, и наоборот.
Как проходит один запуск
- Игрок открывает публичную страницу кампании и начинает регистрацию.
- Идентификатор кампании передаётся вместе с регистрацией, без списка предметов или шансов от браузера.
- После успешной регистрации внутри каждой группы случайно выбирается одна награда согласно настройкам.
- Выбранные награды ставятся в очередь доставки и поступают на склад игрока.
- Игрок передаёт предметы со склада на выбранный игровой аккаунт или персонажа обычным способом.
Один новый мастер-аккаунт может участвовать в кампании один раз. Повтор запроса доставки не создаёт копии предметов.
Страница кампании
Публичный адрес имеет вид /promo/{ID}. Страница показывает сервер, лимит кампании, независимые группы, возможные награды и их шансы до регистрации. Браузер не выбирает выигрыш: итог рассчитывается после успешного создания аккаунта.
На мобильном экране карточки перестраиваются в одну колонку, при этом названия, количество и шанс каждой награды остаются видны.
Панель администратора
Перед настройкой
Проверьте, что проект и игровой сервер включены. Подготовьте ID предметов, количество, заточку и изображения наград. Для каждой группы заранее определите вероятности: их сумма должна быть равна 100%.
Список промо-игр
Откройте Дополнения -> Промо-игры. В таблице отображаются название, игровой сервер, проект, лимит призов и дата создания. Название открывает редактирование, поиск помогает найти нужный набор.
Создание
Нажмите Создать и заполните основные поля:
- Укажите понятное название розыгрыша.
- Выберите проект и игровой сервер, на который будут доставляться награды.
- Задайте количество призов, которое подключённый сценарий использует как верхнюю границу розыгрыша.
- Добавьте предметы и распределите их по группам.
Поля награды
| Поле | Назначение |
|---|---|
| Группа | Объединяет альтернативные награды. Из каждой группы выбирается один предмет. |
| ID предмета | Идентификатор предмета в сборке игрового сервера. |
| Количество | Число предметов в одной выдаче. |
| Заточка | Уровень заточки для платформ, которые его поддерживают. |
| Название | Понятное имя для панели и результатов проверки. |
| Изображение | Путь или HTTPS-ссылка на изображение предмета. Кнопка загрузки сохраняет PNG, JPEG или WebP в файлах выбранного проекта и сразу показывает предпросмотр. |
| Шанс | Вероятность выбора предмета внутри группы. |
Сводка над списком пересчитывается сразу после изменения группы или шанса. Сохраняйте набор только после того, как каждая группа показывает 100%.
Понятный пример
Создадим промо-игру «Награда нового игрока» с двумя группами.
| Группа | Награда | Шанс | Результат группы |
|---|---|---|---|
| 1 | 500 000 Adena | 60% | Выбирается одна из трёх наград |
| 1 | 20 Soulshot Tickets | 25% | Выбирается одна из трёх наград |
| 1 | 100 L-Coin | 15% | Выбирается одна из трёх наград |
| 2 | Свиток новичка | 100% | Выдаётся при каждом запуске |
Игрок не получает все строки первой группы. Например, один запуск может выдать 500 000 Adena из группы 1 и гарантированный Свиток новичка из группы 2. Другой игрок может получить 100 L-Coin и тот же свиток.
Группы используются для независимых частей комплекта. Альтернативные награды помещайте в одну группу, а гарантированный дополнительный предмет - в отдельную группу с единственной строкой и шансом 100%.
Редактирование
Откройте промо-игру по названию. Можно изменить проект, сервер, лимит и состав наград. Перенос существующей игры на другой сервер меняет место доставки следующих наград, поэтому сначала проверьте интеграцию на тестовом аккаунте.
Проверка шансов
В сохранённой промо-игре нажмите Тест-игра. Панель выполнит 1000 симуляций и покажет для каждого предмета:
- настроенный шанс;
- фактический результат симуляции;
- количество побед;
- группу награды.
Небольшое отклонение результата от заданного шанса нормально. Если отклонение выглядит большим, повторите тест и проверьте, что сумма шансов каждой группы равна 100%.
Запуск
После сохранения обновите конфигурацию установленного клиента и откройте /promo/{ID}. Зарегистрируйте тестового игрока со страницы кампании и проверьте выбранные награды на его складе.
Перед публикацией проверьте:
- сценарий использует нужную промо-игру, проект и сервер;
- сумма шансов каждой группы равна 100%;
- один запуск выбирает только одну награду из каждой группы;
- количество, заточка и изображения соответствуют настройке;
- повторная отправка одного участия не создаёт вторую выдачу;
- игрок видит условия и возможные награды до регистрации;
- временная ошибка доставки повторяется автоматически и не создаёт дубли.
Удаляйте промо-игру только после отключения сценария, который использует её идентификатор.