Триггеры

Концепция

Модуль триггеров поможет вам автоматизировать выдачу бонусов для игроков.
В триггерах можно добавлять условия для активации триггера.
К каждому триггеру можно добавить бонусы, которые начислятся игроку - награды, достижения и покупки. Не более 10.
Выдача наград происходит вручную или автоматически, если у триггера указана автовыдача награды.
Триггер можно активировать только один раз.
Триггеры будут храниться активированными всегда, через SDK нельзя деактивировать триггер.
Активация триггера не требует отдельного запроса. Триггеры активируются только автоматически при синхронизации игрока.
Вам доступна информация о триггерах и списке активированных игроком триггеров.
Информацию о триггерах не нужно получать отдельным запросом, они доступны при старте игры.
Информацию об активированных игроком триггерах не нужно получать отдельным запросом, они доступны после автозагрузки игрока при старте.
Количество триггеров ограничено: 10 - при обычном плане использования, 100 - при платном плане использования.

📄️ Триггеры API

Интеграция триггеров через SDK. Методы работы.

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

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

В форме добавления вы можете:

Указать тег для более удобного использования триггера.
Указать название для себя, чтобы удобнее ориентироваться по триггерам.
Указать описание для игрока, рассказать как выполнить условия триггера.
Указать видимость. Всем игрокам или только в режиме тестирования.
Указать будут ли автоматически начисляться бонусы при активации триггера.
Добавить условия активации триггера (ниже).
Добавить бонусы при активации триггера (ниже).

Настраивайте условия для активации триггера

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

Это позволит вам:

Менять условия получения триггера в реальном времени.
Обойтись без дополнительного кода.

Конструктор условий выглядит так:

Такое условие обозначает:

Активируй триггер, если игрок Разбойник или Маг и достиг 10 уровня, а так же, если игрок Воин и достиг 12 уровня.

В переводе на код:

const isActivated =
    (player.level >= 10 && (player.class === 'rogue' || player.class === 'mage')) ||
    (player.level >= 12 && player.class === 'warrior');

В редакторе условий вам доступен список полей игрока:

Базовые поля: Очки, Имя, Аватар
Настраиваемые поля: Любые ваши поля

Так же доступен список полей статистики игрока:

По дням: Всего дней и Всего дней подряд
По времени: Времени в игре и Времени в игре сегодня

Всего можно совершить 6 операций сравнения над полями:

Поле == равно значению.
Поле != не равно значению.
Поле > больше значения.
Поле < меньше значения.
Поле >= больше либо равно значению.
Поле <= меньше либо равно значению.

Сравнения >, <, >=, <= допустимы только для числовой переменной.

Так же внутри значения для сравнения можно указать несколько вариантов через ИЛИ.

Множественные сравнения допустимы только при операциях == и !=, кроме булевых переменных.

Настраивайте бонусы при активации триггера

Вы можете настроить автоматическую выдачу наград при активации триггера.

Это позволит вам:

Регулировать бонусы в реальном времени.
Обойтись без дополнительного кода.

Конструктор бонусов выглядит так:

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

Всего доступно 3 типа бонусов:

Награды;
Достижения;
Покупки.

Как начать

Перейдите в ваш проект в Панели GamePush;
Перейдите в раздел Триггеры;
Добавьте первый триггер;
Ознакомьтесь с работой с триггерами в SDK и отслеживайте активацию триггеров.

Перейти к документации по SDK 👇