Наборы (Kit)
Набор — это группа предметов, которые игрок получает ОДНОЙ покупкой. В отличие от рулетки, игрок получает ВСЁ, что входит в набор.
Как создать набор
- Админка → Каталог → Создать товар
- Тип товара: Набор
- В блоке «Состав набора» добавьте предметы:
Каждый предмет в наборе:
├── ID — уникальный идентификатор
├── Название — как показывается игроку
├── Картинка (опционально) — URL с CDN
└── Payload — что именно выдаётся в игре
Возможные payload-типы внутри набора:
| Тип | Что выдаётся | Пример |
|---|---|---|
item | Предмет через RCON | AK-47 × 1 |
currency | Валюта (scrap, etc.) | 1000 scrap |
command | RCON-команда | addgroup {player} vip |
recipe | Чертеж | Blueprint × 1 |
Qty (количество)
Каждый предмет в наборе имеет своё количество:
- item:
qty— количество штук (например, 64 патрона) - currency:
amount— единиц валюты (например, 1000 scrap) - command/recipe: всегда 1 (qty нерелевантен)
Картинки предметов в наборе
Витрина показывает картинки тремя способами (по приоритету):
- Кастомный
imageUrl— если владелец загрузил картинку вручную - Rust CDN — для
itemс указаннымrustItem.idвитрина подставляет иконкуcdn.tirify.shop/rust-items/{id}.png - Плейсхолдер — если ни один источник не дал картинку, показывается стандартная иконка из набора Icons
Не использовать rustclash.com
Иконки wiki.rustclash.com/item/... имеют hotlink-protection (ошибка 403). Всегда указывайте свой imageUrl или полагайтесь на наш CDN.
Как игрок видит набор
На витрине набор показывается так:
- Плитка товара — стандартная карточка, как у любого товара
- Quick-view — при клике открывается диалог с деталями
- Секция «Состав набора» — сетка иконок с названиями и количеством
В личном кабинете (после покупки) — таблица выданных предметов со статусом.
Пример: стартовый набор Rust
| Предмет | Тип | Qty |
|---|---|---|
| AK-47 | item | 1 |
| Патроны 5.56 | item | 128 |
| Дерево | item | 5000 |
| Камень | item | 5000 |
| VIP-статус (команда) | command | 1 |
Цена: 500 ₽. Игрок получает всё сразу одной покупкой.
Лимиты
- Минимум 1 предмет, максимум 50 предметов в наборе
cooldownSecondsиperPlayerLimit— действуют на ВЕСЬ набор, а не на отдельные предметы