⚙️ Руководство администратора

NSKRUST Store - Полная документация по управлению магазином

Начало работы Товары Серверы Платежи Заказы Пользователи Промокоды Rust плагин API Настройки

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

Первые шаги после установки:

  1. Войдите в админ-панель по адресу /admin
  2. Добавьте сервер - укажите IP, порт и RCON
  3. Создайте категории для товаров
  4. Добавьте товары с командами выдачи
  5. Настройте платёжную систему (YooKassa или FreeKassa)
  6. Установите плагин на игровой сервер
💡 Совет: Начните с тестирования на одном сервере. Убедитесь, что выдача работает правильно, прежде чем открывать магазин для игроков.

📦 Управление товарами

Создание товара:

Перейдите в Админ → Товары → Добавить товар

Поле Описание
Название Отображается в магазине
Slug URL-адрес товара (генерируется автоматически)
Категория Группировка товаров
Цена / Старая цена Старая цена показывает скидку
Тип Привилегия, предмет, кит, валюта
Команда Консольная команда для выдачи
Серверы На каких серверах доступен

Команды выдачи:

В поле "Команда" укажите консольную команду сервера. Используйте плейсхолдеры для подстановки данных игрока:

Плейсхолдер Значение
{steam_id} Steam ID игрока (76561198...)
{username} Никнейм игрока
{quantity} Количество товара
{product_name} Название товара

Примеры команд:

# Выдача привилегии VIP на 30 дней
oxide.grant user {steam_id} vip.use
oxide.usergroup add {steam_id} vip

# Выдача предмета
inventory.giveto {steam_id} rifle.ak 1

# Выдача валюты (ServerRewards)
sr add {steam_id} 1000

# Выдача кита
kit.give {steam_id} starter

# Несколько команд (разделяются ;)
oxide.grant user {steam_id} vip.use; oxide.usergroup add {steam_id} vip; say {username} купил VIP!
⚠️ Внимание: Тестируйте команды в консоли сервера перед добавлением товара!

🖥️ Настройка серверов

Добавление сервера:

Перейдите в Админ → Серверы → Добавить сервер

Поле Описание
Название Отображаемое имя сервера
IP адрес IP или домен сервера
Порт игры Обычно 28015
RCON порт Обычно 28016
RCON пароль Для выполнения команд
API Key Генерируется автоматически для плагина

Настройка RCON в Rust:

В файле server.cfg или параметрах запуска:

+rcon.web 1
+rcon.port 28016
+rcon.password "ваш_пароль"
🔒 Безопасность: Используйте сложный RCON пароль и не передавайте его третьим лицам!

💳 Настройка платёжных систем

YooKassa (ЮKassa):

  1. Зарегистрируйтесь на yookassa.ru
  2. Создайте магазин и получите Shop ID и Secret Key
  3. В личном кабинете укажите URL для уведомлений: https://ваш-сайт.ru/payment/yookassa/callback
  4. В админке сайта: Платёжные системы → YooKassa → Настроить

FreeKassa:

  1. Зарегистрируйтесь на freekassa.ru
  2. Добавьте магазин и получите Merchant ID, Secret Key 1 и Secret Key 2
  3. Укажите URL уведомления: https://ваш-сайт.ru/payment/freekassa/callback
  4. URL успеха: https://ваш-сайт.ru/payment/success
  5. URL отмены: https://ваш-сайт.ru/payment/fail
📌 Файл .env: Ключи платёжных систем также нужно указать в файле .env 
YOOKASSA_SHOP_ID=123456
YOOKASSA_SECRET_KEY=your-secret-key

FREEKASSA_MERCHANT_ID=12345
FREEKASSA_SECRET_KEY=key1
FREEKASSA_SECRET_KEY_2=key2

📋 Управление заказами

Статусы заказов:

Статус Описание Действие
Pending Ожидает оплаты Ждём платёж
Paid Оплачен Автоматическая выдача
Processing Обрабатывается Идёт выдача
Completed Выполнен Товар выдан
Failed Ошибка Проверить логи
Refunded Возврат Деньги возвращены

Ручная выдача:

Если автовыдача не сработала:

  1. Откройте заказ в админке
  2. Нажмите "Выдать повторно"
  3. Или выполните команду вручную в RCON консоли сервера

👥 Управление пользователями

Возможности:

Массовые действия:

В списке пользователей можно выбрать несколько и применить действие ко всем.

🎁 Промокоды

Типы промокодов:

Тип Описание Пример
Процентная скидка Скидка в % от суммы заказа 10% скидка
Фиксированная скидка Фиксированная сумма скидки -100 ₽
Бонус на баланс Начисление на баланс сайта +50 ₽ на баланс

Ограничения:

🎮 Установка Rust плагина

Установка:

  1. Скопируйте NSKRustStore.cs в папку oxide/plugins/
  2. Плагин создаст конфигурацию в oxide/config/NSKRustStore.json
  3. Отредактируйте конфигурацию - укажите URL сайта и API Key
  4. Перезагрузите плагин: oxide.reload NSKRustStore

Конфигурация плагина:

{
  "API URL": "https://ваш-сайт.ru/api/v1",
  "API Key": "ключ-из-админки-серверы",
  "Интервал проверки выдачи (секунды)": 30.0,
  "Интервал обновления онлайна (секунды)": 60.0,
  "Включить автовыдачу": true,
  "Включить команды чата": true,
  "Включить GUI магазин": true,
  "Префикс сообщений": "[МАГАЗИН]",
  "Показывать баланс при подключении": true
}

Команды плагина:

Команда Описание
/balance Показать баланс игрока
/shop Открыть GUI магазина
/buy [ID] [кол-во] Купить товар
/donate Ссылка на сайт
store.reload Перезагрузить конфиг (админ)
💡 API Key: Найдите его в админке: Серверы → Ваш сервер → API Key

🔌 API для разработчиков

Базовый URL:

https://ваш-сайт.ru/api/v1

Авторизация:

Передавайте API Key в заголовке:

X-API-Key: ваш-api-key

Эндпоинты:

GET /player

Информация об игроке

?steam_id=76561198...

GET /balance

Баланс игрока

?steam_id=76561198...

POST /balance

Изменить баланс

steam_id, amount, reason

GET /products

Список товаров

POST /buy

Покупка товара

steam_id, product_id, quantity

GET /deliveries

Ожидающие выдачи

POST /deliveries/confirm

Подтвердить выдачу

order_id

POST /server/update

Обновить онлайн сервера

online_players, max_players

⚙️ Общие настройки

Файл .env:

Основные настройки находятся в файле .env в корне проекта:

# Основные
APP_NAME="NSKRUST Store"
APP_URL=https://ваш-сайт.ru
APP_DEBUG=false

# База данных
DB_HOST=localhost
DB_DATABASE=nskrust_store
DB_USERNAME=root
DB_PASSWORD=

# Steam
STEAM_API_KEY=ваш-steam-api-key

# Платежи
YOOKASSA_SHOP_ID=
YOOKASSA_SECRET_KEY=
FREEKASSA_MERCHANT_ID=
FREEKASSA_SECRET_KEY=
FREEKASSA_SECRET_KEY_2=

Кэширование:

После изменения настроек выполните:

php artisan config:cache
php artisan route:cache
php artisan view:cache

Очистка кэша:

php artisan cache:clear
php artisan config:clear
⚠️ Важно: После изменения .env всегда выполняйте php artisan config:cache на продакшене!
← Руководство пользователя | На главную →