Колесо фортуны

Лотерея на витрине: игрок крутит колесо и получает приз — товар из каталога (выдаётся в игру) или баланс магазина. Раздел панели Колесо фортуны, на витрине — страница /wheel и пункт «Колесо» в навигации.

Как это работает для игрока

Заходит через Steam и открывает «Колесо».
Видит, сколько вращений доступно, и барабан с призами (цветная полоска сверху карточки — редкость: от голубой «обычной» до золотой «легендарной»).
Нажимает «Крутить» — лента прокручивается и останавливается на выпавшем призе.
Товар попадает во внутриигровую корзину магазина (как обычная покупка, только бесплатно) — игрок забирает его кнопкой «Получить» в игре, когда будет онлайн; баланс зачисляется сразу.

Под барабаном — «Мои выигрыши» с историей.

Откуда берутся вращения

Вид	Как получить	Настройка
Бесплатное	Раз в N часов каждому игроку	«Бесплатное вращение раз в, часов» (0 — выключить)
Бонусное	Выдаёт владелец по SteamID	Блок «Выдать вращения игроку»
Платное	Игрок покупает за баланс магазина	«Цена платного вращения, ₽» (0 — не продавать)

Порядок списания: бесплатное → бонусные → платное. Платное списывается только по отдельной кнопке «Крутить за N ₽» после подтверждения — случайно потратить баланс нельзя. Отдельной комиссии с вращений нет — на комиссионном тарифе она уже взята при пополнении баланса.

Призы

Приз — это любой предмет Rust, товар из каталога или баланс магазина.

Предмет Rust. Выбирается из справочника предметов (как при создании товара), количество — диапазон в штуках: сера от 1 до 1000. Под предмет автоматически заводится скрытый служебный товар колеса, в каталоге и категориях он не показывается.
Товар. Любой товар магазина, в том числе скрытый с витрины (так удобно заводить «только для колеса»). Для предметов задаётся диапазон количества: товар «Ткань ×100» с диапазоном 5–20 выпадает как 500–2000 шт. Для китов и привилегий количество всегда 1 — выдаётся доступ или срок из товара.
Баланс. Сумма в рублях, зачисляется сразу.

Шанс приза = его вес ÷ сумма весов включённых призов. Веса — любые целые: 50 / 30 / 15 / 5 дадут 50 %, 30 %, 15 %, 5 %. Панель показывает итоговый шанс и редкость у каждого приза. Розыгрыш честный: сервер выбирает приз криптографическим генератором, клиент только показывает анимацию.

Скрытый приз не выпадает и не показывается; удалить можно только скрытый. История вращений хранит снимок приза, поэтому удаление ничего не ломает.

Выдача и учёт

Приз-товар оформляется как заказ на 0 ₽ (источник «колесо фортуны») — виден игроку в «Списке покупок» со статусом «В корзине» и владельцу в «Заказах». Забирается в игре кнопкой «Получить», как обычная покупка; товары с галкой «Выдавать сразу» уходят в инвентарь напрямую. Кнопки «Вернуть» у приза нет — возвращать нечего.
Приз-баланс и оплата вращения — операции кошелька игрока с пометками «Колесо фортуны».
Если на витрине несколько серверов, приз привязывается к выбранному игроком серверу (как покупка).

Плагин на сервере обновлять не нужно — выдача идёт через ту же очередь, что и покупки.