Игровые системы

Ивенты на время: фестиваль с треком призов

Как работают готовые ивенты на время iDos Games - события с жетонами, треком вех, VIP-призами и суточными лимитами - и как настроить их в кабинете.

Обновлено: English

Ивенты на время - фестивали: игрок зарабатывает жетоны ивента и поднимается по треку призов. Ивент может пройти один раз, повторяться по расписанию или идти цепочкой, а VIP-пропуск добавляет второй приз на каждой вехе.

Что видит игрок

  • Каждый активный ивент - вкладка с названием и таймером.
  • Полосу жетонов до следующего приза и трек вех.
  • Второй VIP-приз на вехах; пропуск, купленный позже, доплачивает уже забранные вехи.
  • «Забрать всё» и окно с тем, как зарабатываются жетоны и их суточные лимиты.
Ивенты
12 450
320
Звёздный фестиваль2
Выходные
Звёзды: 340 / 500
3d 08:00
100
200
300
500
Как заработать звёзды
Забрать всё
Получить VIP
Каждый активный ивент - вкладка со своим таймером.
Трек вех; VIP-пропуск добавляет второй приз на каждой.
«Забрать всё» одним вызовом; как зарабатываются жетоны и их суточные лимиты.
Пример. Экран ивентов: вкладка ивента, полоса жетонов и трек вех.

Как устроено

  • Жетоны приходят из источников ивента: действие в игре, покупка, квест и другие.
  • Сыгранный раунд - своё действие, о котором сообщает игра; минимальный шаблон делает это для каждого ивента, где оно указано.
  • «Получить VIP» открывает экран VIP, если он стоит.

Шаг 01Добавьте систему в проект

Попросите ИИ-кодер: «Добавь недельный ивент с призами». Он поставит готовую систему с недельным «Звёздным фестивалем»: пять вех и VIP-приз на каждой.

Шаг 02Настройте в кабинете

Откройте кабинет, выберите проект и перейдите в LiveOps → v2 → Тайм-эвент.

  • Создайте ивент: расписание (один раз, по кругу или цепочкой) и жетон.
  • Добавьте источники жетонов с суточными лимитами.
  • Соберите трек вех: пороги, награды и VIP-призы.

Кнопка ИИ на странице открывает помощника: опишите, что нужно, он предложит правки, а вы проверите их и нажмёте Сохранить.

Шаг 03Проверьте и выпустите

Проверьте систему в тестовой версии приложения. В живое приложение настройки уходят отдельным действием - см. публикация и ссылки.

Для разработчиков

Ивенты работают через client.timedEvent из @idosgames/core.

TypeScript
// Сыгран раунд: жетоны за действие 'play_round' каждого активного ивента
const res = await client.timedEvent.getActiveEvents()
for (const e of res.ok ? (res.data.ActiveEvents ?? []) : [])
  if (e.CanEarn !== false && e.Type && e.TimedEventID)
    await client.timedEvent.grantTokens(e.Type, e.TimedEventID, 'CustomAction', undefined, undefined, {
      ActionName: 'play_round',
    })
// Забрать все ждущие вехи всех ивентов одним вызовом
await client.timedEvent.claimAllMilestones()
  • Игра начисляет жетоны только через источники, указанные у ивента; лимиты применяет сервер.
  • Трек читайте из getActiveEvents(): там же хранятся забранные вехи.

Подробное описание полей - в навыке timed-event-system, его отдаёт MCP-сервер SDK.

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

Ивент может повторяться каждую неделю?

Да. Ивент проходит один раз, повторяется по расписанию или идёт цепочкой фаз.

Как игроки зарабатывают жетоны?

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

Смотрите также

Сделайте свою игру

Опишите идею одним предложением - ИИ-кодер соберёт её, и она откроется по своей ссылке.