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

Лутбоксы и сундуки в игре

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

Обновлено: English

Лутбоксы - готовая система сундуков: игрок открывает сундук за валюту, предмет-сундук или ключ, а что выпадет, решает сервер. Результат нельзя подделать из игры, а каждое открытие показывает, как награды вылетают из сундука.

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

  • Карточку на каждый способ открыть сундук: валюта, предмет-сундук, ключ.
  • «Открыть» и «Открыть x10», где позволяют лимит сундука и баланс.
  • Анимацию открытия: сундук трясётся, пока сервер выбрасывает результат, раскрывается, и награды вылетают.
  • Значок с числом сундуков, которые можно открыть тем, что есть у игрока.
Сундуки
12 450
320
Золотой сундук
100
Сундук героя
Ключ
2
Открыть x10

Десять сразу, в пределах лимита сундука и баланса.

900
Эпический меч
x1
Монеты
+2 500
Карточка на каждый способ открыть: валюта, предмет-сундук или ключ; значок считает доступные.
«Открыть x10», где позволяют лимит и баланс.
Результат выбрасывает сервер; награды вылетают из сундука.
Пример. Экран сундуков: способы открыть, «Открыть x10» и выпавшие награды.

Как устроено

  • Содержимое сундука и шансы задаются в кабинете; при каждом открытии результат выбрасывает сервер.
  • Сундук или ключ из инвентаря открывает этот экран с нужным сундуком.
  • В шаблоне idle-RPG лутбокс работает как призыв снаряжения.

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

Попросите ИИ-кодер: «Добавь сундуки». Он поставит готовую систему; вкладка появится, когда сундук будет настроен.

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

Откройте кабинет, выберите проект и перейдите в LiveOps → v2 → Лутбокс.

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

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

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

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

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

Лутбоксы работают через client.lootbox из @idosgames/core.

TypeScript
// Открыть сундук десять раз выбранным способом оплаты
const res = await client.lootbox.open('gold_chest', 10, 'gems')
if (!res.ok) return showError(res.error)
// Выпавшее уже применено к балансам и инвентарю в кэше SDK
  • Никогда не выбрасывайте результат на клиенте: он приходит только в ответе сервера.
  • Блокируйте кнопку, пока идёт запрос: каждый вызов - отдельное открытие.

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

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

Можно показать шансы?

Да. Содержимое и веса сундука лежат в настройках тайтла, и игра может показать их рядом с сундуком.

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

Да. Предмет-сундук или ключ открывает этот экран с подходящим сундуком.

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

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

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