Pterohost docs

Oxide и плагины на сервер Rust: установка и настройка

Как установить Oxide (uMod) на сервер Rust, добавить плагины, настроить права доступа и обновить мод-фреймворк после обновления игры.

Oxide (он же uMod) - это мод-фреймворк для сервера Rust, который открывает возможность установки плагинов: от экономики и магазинов до кастомных событий и инструментов администрирования. Если вы хотите запустить сервер с плагинами для Rust, эта инструкция проведёт вас через весь процесс.

Что понадобится

  • Запущенный сервер Rust (App ID 258550 через SteamCMD)
  • Доступ к файловой системе сервера (FTP, SSH или панель управления)
  • Базовое понимание структуры папок сервера

Oxide работает поверх стандартных серверных файлов и не требует отдельной установки зависимостей. Совместимость: Oxide обновляется вместе с каждым обновлением Rust.

Хотите чтобы Oxide и популярные плагины были установлены сразу? Сервер Rust на Pterohost - автоустановка Oxide, NVMe SSD, AMD Ryzen 9 7950X3D и удобная панель для управления плагинами. По промокоду 4START скидка 20% на первый заказ.

Установка Oxide (uMod)

Шаг 1: Скачать Oxide

Перейдите на umod.org, раздел Games - Rust. Скачайте архив Oxide.Rust.zip с последней версией. Всегда скачивайте именно для Rust - существуют версии для разных игр.

Шаг 2: Распаковать поверх серверных файлов

Распакуйте содержимое Oxide.Rust.zip прямо в корневую папку серверных файлов RustDedicated - туда, где находится исполняемый файл RustDedicated (Linux) или RustDedicated.exe (Windows). Соглашайтесь на замену файлов при запросе.

# Пример для Linux
cd ~/rust-server
unzip ~/Downloads/Oxide.Rust.zip -d ./

Шаг 3: Запустить сервер

Запустите сервер обычным способом. В логах должны появиться строки вида:

[Oxide] Loading extensions...
[Oxide] Version 2.0.XXXX for Rust XXXXX
[Oxide] Loading plugins...

После первого запуска с Oxide в корне серверных файлов появится папка oxide/ со следующей структурой:

oxide/
  plugins/     - плагины (.cs файлы)
  config/      - конфиги плагинов (JSON)
  data/        - данные плагинов (базы игроков, хранилища)
  lang/        - языковые файлы плагинов
  logs/        - логи плагинов

Работа с плагинами

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

Скачайте файл плагина с расширением .cs с сайта umod.org или codefling.com и скопируйте его в папку oxide/plugins/.

Oxide загрузит плагин автоматически без перезапуска сервера. В консоли появится:

[Oxide] Loading plugin PluginName v1.0.0

Основные команды управления плагинами

КомандаДействие
oxide.reload PluginNameПерезагрузить конкретный плагин
oxide.reload *Перезагрузить все плагины
oxide.unload PluginNameВыгрузить плагин (без удаления файла)
oxide.load PluginNameЗагрузить ранее выгруженный плагин
oxide.versionПоказать версию Oxide
pluginsСписок всех загруженных плагинов

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

После первой загрузки плагин создаёт свой конфиг в oxide/config/PluginName.json. Отредактируйте его и перезагрузите плагин:

# Пример конфига плагина
nano oxide/config/Economics.json
{
  "Starting Balance": 1000,
  "Max Balance": 1000000,
  "Log Transactions": false
}

После изменения конфига выполните в консоли сервера oxide.reload Economics.

Система прав Oxide

Oxide использует систему групп и прав доступа. Каждый плагин регистрирует свои права вида pluginname.permission.

Группы по умолчанию

ГруппаОписание
defaultВсе игроки автоматически
adminАдминистраторы сервера
moderatorМодераторы (если настроен)

Управление правами

# Посмотреть права плагина
oxide.show perms

# Выдать право игроку
oxide.grant user STEAMID64 pluginname.permission

# Выдать право группе
oxide.grant group default pluginname.permission

# Создать свою группу
oxide.group add vip

# Добавить игрока в группу
oxide.usergroup add STEAMID64 vip

# Выдать право группе vip
oxide.grant group vip pluginname.vip

Популярные плагины для Rust

ПлагинЧто делает
EconomicsВнутриигровая экономика и валюта
ShopМагазин за внутреннюю валюту
KitsНаборы снаряжения
BackpacksДополнительный инвентарь
InfoPanelИнформационная панель на HUD
NightVisionНочное видение
TeleportGUIТелепорты игроков
SignArtistЗагрузка изображений на знаки
DiscordMessagesУведомления в Discord
GatherManagerНастройка скорости сбора ресурсов

Обновление Oxide после обновления Rust

Каждый первый четверг месяца Rust получает принудительное обновление. Oxide необходимо обновлять вместе с игрой - старая версия Oxide несовместима с обновлёнными бинарными файлами.

Порядок обновления:

  1. Остановите сервер
  2. Обновите серверные файлы Rust через SteamCMD (app_update 258550)
  3. Скачайте новую версию Oxide с umod.org
  4. Распакуйте поверх серверных файлов
  5. Запустите сервер

Плагины при этом трогать не нужно - они перекомпилируются автоматически. Однако некоторые плагины могут временно не работать, если их автор не обновил код под новый API Rust.

Частые ошибки

Oxide не загружается после обновления Rust - вы используете старую версию Oxide. Скачайте актуальную сборку с umod.org и установите поверх.

Плагин не компилируется, ошибка в консоли - плагин устарел и не совместим с текущей версией Rust или Oxide. Найдите обновлённую версию на umod.org или в Issues на GitHub автора.

Папка oxide не создаётся - проверьте, что Oxide распакован именно в корень серверных файлов, а не во вложенную папку.

Команды oxide.grant не работают - убедитесь, что выполняете команды в консоли сервера (не в игровом чате). В чате добавляйте / перед командой, в серверной консоли - без /.

Права не сохраняются после перезапуска - данные Oxide хранятся в oxide/data/. Убедитесь, что файлы не доступны только для чтения.

Уже есть сервер и хотите надёжный хостинг? Перейдите на Pterohost - панель управления упрощает установку и обновление Oxide, все файлы доступны через удобный файловый менеджер. По промокоду 4START скидка 20% на первый заказ.

Часто задаваемые вопросы

Как установить Oxide на сервер Rust? Скачайте актуальную сборку Oxide/uMod для Rust с сайта umod.org, распакуйте архив поверх папки с серверными файлами RustDedicated и перезапустите сервер. Oxide загрузится автоматически при старте.

Чем Oxide отличается от uMod? Это одно и то же. Oxide - историческое название фреймворка, uMod - новое название после ребрендинга. На сайте umod.org вы найдёте актуальные версии под именем uMod, но в интерфейсе сервера по-прежнему встречается “Oxide”.

Куда кидать плагины на сервере Rust? Файлы плагинов (.cs) копируют в папку oxide/plugins/ в корне серверных файлов. Oxide загружает их автоматически без перезапуска сервера.

Где скачать плагины для сервера Rust? Основная площадка - umod.org (раздел Games - Rust). Также популярен codefling.com. Большинство плагинов там бесплатны, часть продаётся.

Почему не работают плагины после обновления Rust? После обновления Rust Oxide необходимо обновить тоже - старая версия несовместима с новыми бинарными файлами игры. Скачайте свежую сборку uMod с umod.org и установите поверх текущей.

Читайте также