Товары: создание, цены, виды
Товар — главная единица каталога. Игрок покупает товар за реальные деньги (через любой подключённый платёжный метод) или за баланс магазина и получает предметы, привилегии, команды в игре.
Создание товара
- Админка → ваш магазин → Каталог → «Создать товар»
- Заполните:
- Название — как товар показывается на витрине
- Slug — URL-адрес страницы товара (генерируется автоматически)
- Категория — группировка товаров
- Цена (в рублях) — розничная цена
- Старая цена (опционально) — показывается перечёркнутой, витрина считает процент скидки
- Выберите тип товара — от этого зависит форма payload ниже
Типы товаров (6 видов)
Tirify поддерживает 6 типов товаров. Выбор типа определяет ЧТО получит игрок после покупки.
Предмет (item)
Обычный товар — игрок покупает и получает указанные предметы или привилегии на сервере.
Когда использовать: оружие, ресурсы, привилегии — любые одиночные товары.
Набор (kit)
Группа предметов, выдаваемых одной покупкой. Игрок получает ВСЁ сразу.
- Любое количество предметов (до 50)
- У каждого своё количество (qty) и картинка
- Показывается на витрине сеткой с иконками
Когда использовать: стартовые наборы, VIP-пакеты, комплекты.
Рулетка (lootbox)
Случайная выдача ОДНОГО предмета из набора. Игрок видит шансы выпадения.
- Каждый предмет имеет вес (чем больше, тем чаще выпадает)
- Шанс = вес предмета / сумма всех весов × 100%
- Минимум 2 предмета, максимум 50
- Редкость: common / uncommon / rare / epic / legendary
- Можно скрыть проценты (
showOdds: false) — игрок не видит точные шансы
Анимация: на витрине запускается рулетка (spin). Через несколько секунд выпадает результат.
Когда использовать: кейсы, лутбоксы, гача-механики.
Рецепт (recipe)
Выдача чертежа (blueprint) — игрок получает возможность изучить и скрафтить предмет.
- Используется для Rust-предметов, которые игрок должен изучить
- Требует, чтобы игрок был онлайн
Когда использовать: чертежи, рецепты, изучаемые предметы.
Выбор (variant_picker)
Товар с вариантами. Игрок выбирает один из вариантов перед покупкой.
- У каждого варианта своё название и опционально картинка
- Delta-цена: вариант может стоить дороже или дешевле базовой цены
- На витрине — выпадающий список или сетка вариантов
Когда использовать: выбор количества патронов (100/500/1000), выбор типа ресурса.
Команда (command)
Сервисная команда на сервере — например смена ника или телепорт.
Когда использовать: простые сервисные действия.
Картинка товара
- Основная картинка — показывается на витрине (плитка + quick-view)
- Плейсхолдер — если картинка не загружена, показывается стандартный Tirify-логотип
- Rust-предметы: если указан
itemIdиз Rust Item List, витрина подставляет иконку с нашего CDN (cdn.tirify.shop/rust-items/{id}.png)
Сток (остатки)
Каждый товар может иметь ограниченный запас:
| Статус | Значение |
|---|---|
in_stock | Неограниченный запас |
limited | Ограниченное количество (например, 50 штук). Считается на витрине |
out_stock | Закончился — кнопка покупки заблокирована |
Бейджи
Товар может иметь бейджи, которые выделяют его на витрине:
| Бейдж | Иконка | Цвет |
|---|---|---|
hot | 🔥 Flame | Красный |
flash | ⚡ Zap | Оранжевый |
new | ⭐ Star | Синий |
Приоритет: если есть скидка (цена ниже старой) — показывается процент скидки. Иначе — бейдж. Иначе — остаток.
Кулдаун и лимиты
- cooldownSeconds — минимальный интервал между покупками для одного игрока (в секундах). 0 = без кулдауна. Особенно важно для лутбоксов.
- perPlayerLimit — сколько раз один игрок может купить товар за всё время.
null= без лимита. - targetServerId — если указан, товар показывается только на выбранном сервере.
null= на всех.