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

Полное руководство по работе с платформой RustDonat

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

1. Регистрация

Для начала работы зарегистрируйтесь на платформе через Steam. Это обеспечивает безопасность и простоту входа.

2. Создание магазина

После регистрации создайте свой первый магазин. Укажите название, описание и настройте внешний вид.

3. Добавление сервера

Добавьте ваш Rust сервер в настройках магазина. Укажите IP адрес и порт RCON для связи.

4. Установка плагина

Скачайте и установите плагин на сервер. Подробная инструкция в разделе "Плагин для сервера".

Совет: Начните с добавления нескольких тестовых товаров, чтобы проверить работу системы.

Настройка магазина

Основные настройки

  • Название магазина — отображается в шапке и SEO
  • Описание — краткое описание для посетителей
  • Логотип — изображение в формате PNG или JPG
  • Цветовая тема — выберите из готовых тем оформления

Настройка домена

Каждый магазин получает поддомен вида yourshop.rustdonat.com. Вы также можете подключить собственный домен в настройках.

Уведомления

Настройте уведомления о новых заказах через Telegram или email.

Товары и категории

Создание категорий

Организуйте товары по категориям для удобства покупателей. Например: VIP статусы, ресурсы, оружие.

Добавление товаров

Для каждого товара укажите:

  • Название и описание
  • Цена — в рублях
  • Команда выдачи — RCON команда для выдачи товара
  • Изображение — фото товара

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

Используйте переменные в командах:

  • {steamid} — Steam ID игрока
  • {username} — Имя игрока
  • {amount} — Количество

Пример: inventory.giveto {steamid} wood 1000

Плагин для сервера

Установка

  1. Скачайте плагин из личного кабинета
  2. Загрузите файл RustDonat.cs в папку oxide/plugins
  3. Перезагрузите плагин командой oxide.reload RustDonat
  4. Отредактируйте конфиг oxide/config/RustDonat.json

Конфигурация

{
  "ApiKey": "ваш_api_ключ",
  "ApiUrl": "https://rustdonat.com/api/v1",
  "CheckInterval": 30
}

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

  • /donate — открыть магазин
  • /donate check — проверить статус

Платежи и YooKassa

Подключение YooKassa

  1. Зарегистрируйтесь на yookassa.ru
  2. Создайте магазин в личном кабинете YooKassa
  3. Получите Shop ID и секретный ключ
  4. Введите данные в настройках платежей RustDonat

Webhook

Укажите в настройках YooKassa URL для уведомлений:

https://rustdonat.com/webhooks/yookassa

Комиссии

YooKassa взимает комиссию согласно вашему тарифу (обычно 3-4%). Платформа RustDonat также взимает небольшую комиссию с продаж.

API документация

Аутентификация

API использует Bearer токены для аутентификации. Токен можно получить в настройках магазина.

Authorization: Bearer ваш_api_токен

Основные эндпоинты

  • GET /api/v1/plugin/delivery/next — получить следующую доставку
  • POST /api/v1/plugin/delivery/acknowledge — подтвердить доставку
  • GET /api/v1/plugin/status — статус подключения

Пример запроса

curl -X GET https://rustdonat.com/api/v1/plugin/status \
  -H "Authorization: Bearer ваш_токен" \
  -H "Content-Type: application/json"