Перейти к основному содержимому

Серверы и RCON-подключение

RCON (Remote Console) — протокол, через который Tirify отправляет команды на игровой сервер. Когда игрок покупает товар, система отдаёт RCON-команду серверу — игрок получает предмет мгновенно.

Как подключить сервер​

  1. Админка → ваш магазин → Серверы → «Добавить сервер»

  2. Заполните:

    • Название сервера — как показывается на витрине
    • IP-адрес — публичный IP игрового сервера
    • Game Port — порт для подключения игроков (не RCON!)
    • RCON Port — порт RCON (обычно game port + 1 или отдельный)
    • RCON Password — пароль из конфигурации сервера

  3. Сохраните. Система проверит подключение.

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

Для Rust-серверов требуется плагин TirifyRUST (C# oxide plugin).

Шаги установки​

  1. Скачайте TirifyRUST.cs из админки (Серверы → «Скачать плагин»)
  2. Положите в папку oxide/plugins/ вашего сервера
  3. В конфиге плагина укажите: 
    ApiUrl: https://api.tirify.shop
    StoreId: <ваш ID магазина>
    RconSecret: <секретный ключ из админки>
  4. Перезагрузите плагин: oxide.reload TirifyRUST

Что делает плагин​

  • Handshake — регистрирует сервер в Tirify (IP + порт)
  • Принимает баскеты — команды на выдачу предметов
  • Отдаёт баланс игрока — проверяет кошелёк
  • Wipe schedule — сообщает о вайпах

RCON-команды​

В настройках товара вы указываете RCON-команду. Система подставляет {player}.

Синтаксис​

give <item> {player} <qty>
addgroup {player} <group>
removegroup {player} <group>

Примеры для Rust​

# Выдать предмет
give AK47 {player} 1
give ammo.rifle {player} 128

# Выдать привилегию
addgroup {player} vip
addgroup {player} premium

# Выдать ресурсы
give wood {player} 5000
give stones {player} 5000
Rust Item ID

Используйте ShortName или ItemID предмета. Справочник: Rust Item List.

Plugin Secret (секретный ключ)​

Plugin Secret — ключ, которым плагин подписывает запросы к API. Генерируется в админке.

  • Создать новый — кнопка «Сгенерировать секрет» на странице сервера
  • Показать — секрет показывается ОДИН раз. Скопируйте и сохраните в конфиг плагина
  • Ротация — можно сгенерировать новый секрет. Старый перестаёт работать через 60 секунд (grace period)
Безопасность

Никогда не передавайте Plugin Secret третьим лицам. Он даёт полный доступ к API плагина вашего магазина. Храните как пароль.

Статус сервера​

На витрине (левый рельс) показывается статус сервера:

СтатусЗначение
ONLINEСервер работает, известен онлайн
OFFLINEСервер не отвечает
UNKNOWNСтатус не определён (первый запуск)

Система автоматически определяет статус сервера и обновляет его.

Сервер-получатель​

Товар можно привязать к конкретному серверу (targetServerId):

  • Если указан — товар показывается ТОЛЬКО на этом сервере
  • Если null — на всех серверах магазина
  • Фильтр серверов на витрине учитывает эту привязку

Следующие шаги​