Документация rustbase.shop

Как запустить и настроить донат-магазин для Rust-сервера на платформе rustbase.shop: подключение платёжной системы, плагин для Oxide/uMod, товары и наборы, оформление витрины, API для разработчиков.

Начало работы

Быстрый старт — rustbase.shop — платформа донат-магазинов для Rust-серверов. Деньги игроков идут напрямую на твою ЮKassa, Робокассу или Pally , выдача предметов …
Как выбрать донат-магазин — Донат-магазин для Rust-сервера выбирают по пяти вещам: куда идут деньги игроков, сколько забирает платформа, как игрок платит, как выдаются товары и можно ли…
Подключение ЮKassa — Платежи идут напрямую на твою ЮKassa — платформа не держит деньги игроков. Для приёма оплаты по СБП нужно привязать магазин ЮKassa в панели.
Сервер и плагин — Автовыдача предметов и онлайн-мониторинг работают через плагин RustBaseStore (Oxide/uMod), который ставится на игровой сервер и общается с магазином по API.
Первый товар — Раздел Товары → + Товар . Минимум — название, категория, тип и цена.

Товары

Типы товаров — В магазине три типа товаров. Все настраиваются в разделе Товары .
Наборы и состав — Набор — это товар, который выдаёт сразу несколько предметов за одну покупку. Удобно для стартовых китов и тематических паков.
Категории — Категории группируют товары на витрине во вкладки. Управляются в разделе Товары → Категории .
Скидки и блокировка — Скидку и временную блокировку товара можно ставить вручную или через публичный REST API (удобно для акций и автоматизации).

Витрина и оформление

Тема и оформление — Базовое оформление витрины — раздел Внешний вид → Дизайн . Доступно на всех тарифах.
Английская версия — У витрины может быть вторая, английская версия — для игроков из-за рубежа. Весь интерфейс (кнопки, профиль, кошелёк, колесо, статистика, лига, ошибки)…
Готовые шаблоны — Шаблон оформления применяет акцентный цвет и (на тарифах со своим CSS) набор стилей одним кликом. Раздел Внешний вид → Дизайн → Готовый шаблон .
Свой CSS — На тарифах «База» и «Про» в разделе Внешний вид → Продвинутая кастомизация можно добавить собственный CSS — он применяется на витрине магазина.
Справочник CSS-переменных — Витрина использует CSS custom properties. Переопредели любую из них в своём CSS через :root{ … } — изменения применятся ко всей витрине.
HTML-виджеты — На тарифах «База» и «Про» можно добавить произвольные HTML-блоки на витрину: баннеры, виджет Discord, плеер VK/YouTube. Раздел Внешний вид → HTML-виджеты .
Веб-аналитика — На тарифах «База» и «Про» можно подключить Яндекс.Метрику и Google Analytics — достаточно указать ID счётчика, код подключится автоматически и без ослабления…

Разработчикам

JS-API витрины — Свой JavaScript (тарифы «База»/«Про», раздел Внешний вид → Продвинутая кастомизация ) исполняется на витрине и имеет доступ к объекту window.RB .
Конфиг-переменные — Поведение витрины можно настроить из своего JS через RB.setConfig({...}) или задав объект window.RB_CONFIG до загрузки.
Рецепты CSS/JS — Готовые примеры для своего CSS/JS (тарифы «База»/«Про»). Опираются на JS-API и CSS-таргетинг.
Публичный REST API — Серверный API для управления магазином из своих сервисов и ботов: товары, скидки, баланс игроков. Базовый адрес — твой магазин (как открывается витрина…
API плагина — Плагин RustBaseStore даёт другим плагинам методы для работы с балансом игрока и консольные команды. Установка и настройка плагина — Сервер и плагин.

Платежи и тарифы

Деньги и комиссия — Платежи игроков поступают напрямую на твою ЮKassa, Робокассу или Pally . Платформа не хранит и не переводит деньги покупателей — она лишь обслуживает витрину…
Промокоды и бонусы — Доступно на платных тарифах. Раздел Маркетинг .
Колесо фортуны — Лотерея на витрине: игрок крутит колесо и получает приз — товар из каталога (выдаётся в игру) или баланс магазина. Раздел панели Колесо фортуны , на витрине …
Свой домен — По умолчанию магазин работает на твой-адрес.rustbase.shop . На тарифах «База» и «Про» можно подключить собственный домен, например shop.example.ru .

Помощь

Частые вопросы — На твоей ЮKassa, Робокассе или Pally. Платформа не держит средства покупателей — платежи идут напрямую к тебе. См. Деньги и комиссия.
Решение проблем — Витрина защищена политикой безопасности (CSP): сторонние скрипты и ресурсы с чужих доменов блокируются намеренно.