RU
Все гайды Плагины / 5 мин чтения

Как установить Oxide/uMod на Rust-сервер

От резервной копии до первого плагина: установка Oxide, проверка версии, папки, команды, JSON-конфиги и решение частых ошибок.

Документация сверена: · RustMods

Цель этого гайда — запустить уже существующий Rust-сервер с Oxide и проверить один плагин. Все консольные примеры ниже вводятся в консоль сервера или авторизованный RCON. Команды с начальным слешем относятся к игровому чату.

1. Что подготовить

Открой панель игрового хостинга: нужны файловый менеджер и консоль сервера. Если у панели есть штатная установка Oxide, используй её и затем переходи к проверке версии. Ручной путь ниже пригодится для сервера с доступом к файлам.

  • Проверь, что обычный Rust-сервер запускается и принимает подключение.
  • Уточни ОС именно сервера: Windows на твоём ПК не означает Windows на хостинге.
  • Запланируй короткую остановку и предупреди игроков.
  • Зафиксируй исходное состояние: адрес сервера, его identity и последние ошибки консоли.

2. Сохрани данные и останови сервер

Перед остановкой выполни сохранение мира, затем останови сервер средствами панели. Сделай копию папки с текущим identity внутри server/, стартового файла и настроек. Если Oxide уже установлен, сохрани также его папки конфигурации, данных и плагинов.

Консоль сервера
server.save
Проверь, что резервную копию можно скачать или восстановить. Скриншот панели и копия одного файла плагина не заменяют копию сохранений.

3. Выбери сборку Oxide

Открой официальный список релизов Oxide.Rust. Выбери стабильную сборку, подходящую к текущему обновлению Rust и ОС сервера. Для Windows и Linux публикуются отдельные архивы. Не выбирай сборку только потому, что её номер больше: сначала прочитай примечания релиза.

Официальные релизы Oxide.Rust ↗

Распакуй архив в отдельную временную папку и посмотри его структуру перед загрузкой.

4. Загрузи файлы в правильную папку

На остановленном сервере перенеси содержимое архива в корень установки Rust с сохранением структуры папок. Ориентир — папка RustDedicated_Data рядом с исполняемым файлом сервера. Одноимённые папки архива и сервера должны объединиться.

Ориентир структуры
RustServer/
  RustDedicated.exe       (Windows)
  RustDedicated           (Linux)
  RustDedicated_Data/
    Managed/
  server/
Не создавай вложенную RustDedicated_Data/RustDedicated_Data и не клади ZIP в oxide/plugins. При несовпадении структуры остановись и проверь архив или инструкцию хостинга.

После загрузки запусти сервер обычным способом. Сначала дождись завершения запуска; затем проверяй Oxide.

5. Убедись, что Oxide загрузился

Консоль сервера / RCON
oxide.version

Ответ должен содержать версию Oxide. Если команда неизвестна, переходи к таблице ошибок ниже. Не ставь сразу десятки плагинов: сначала добейся корректного ответа этой команды.

Папка по умолчаниюНазначение
oxide/pluginsФайлы плагинов .cs
oxide/configНастройки плагинов .json
oxide/dataСохраняемые данные плагинов
oxide/logsЖурналы для диагностики

6. Проверь один плагин на примере Server Info

На странице RustMods Server Info скачай релиз после входа в RustMods ID. Распакуй ZIP и найди RustModsServerInfo.cs. README и пример JSON пригодятся для настройки, а в папку плагинов нужен сам файл .cs.

Открыть RustMods Server Info ↗

Файл на сервере
oxide/plugins/RustModsServerInfo.cs

После загрузки посмотри консоль. Убедись, что нет ошибки компиляции, а затем введи в игровом чате команду ниже. Должно появиться информационное сообщение сервера.

Игровой чат
/serverinfo
Название файла при перезагрузке — RustModsServerInfo, без .cs. Другие плагины могут использовать другие чат-команды и требовать отдельные права. Смотри их описание.

7. Измени конфиг и проверь результат

Настройки настраиваемого плагина обычно появляются в oxide/config после первой успешной загрузки. Сохрани копию JSON, меняй по одному параметру и соблюдай типы значений. Следующий фрагмент показывает только синтаксис, а не готовый конфиг Server Info.

Пример синтаксиса JSON
{
  "Enabled": true,
  "Message": "RustMods test"
}

Для обычной перезагрузки этого плагина используй команду ниже. Если плагин перезаписывает настройки при выгрузке, сначала выполни oxide.unload RustModsServerInfo, затем отредактируй файл и выполни oxide.load RustModsServerInfo.

Консоль сервера / RCON
oxide.reload RustModsServerInfo

8. Если что-то не заработало

СимптомЧто проверить первым
oxide.version — неизвестная командаВ консоли нужного сервера проверь установку Oxide, структуру архива и шаг обновления при запуске.
Нет папки pluginsСначала добейся успешного запуска с Oxide; пустая папка сама по себе ничего не устанавливает.
Плагин не компилируетсяСкопируй первую ошибку из консоли, сверь совместимость и зависимости на странице плагина.
Конфиг не применяетсяПроверь JSON: кавычки, запятые, скобки; затем перезагрузи нужный плагин.
Нет ответа на /serverinfoПроверь загрузку RustModsServerInfo и ввод команды именно в игровом чате.

9. Что делать после обновления Rust

Обновление или проверка файлов игры через SteamCMD может заменить изменённые файлы. Планируй порядок: резервная копия → обновление Rust → совместимая сборка Oxide → запуск → oxide.version → проверка плагина. Проверь, не запускает ли стартовый скрипт обновление игры уже после установки Oxide.

Если работающий сервер перестал запускаться после обновления, сохрани лог и сравни версии. Не удаляй сохранения мира ради проверки одного плагина.

10. Контрольная проверка

  • Сервер запускается без критической ошибки.
  • oxide.version возвращает версию.
  • Тестовый плагин загружается и отвечает на команду.
  • Изменённая настройка применяется и сохраняется после перезапуска.
  • Есть резервная копия и понятный порядок следующего обновления.

Теперь можно добавлять остальные плагины по одному. Фиксируй, что меняешь и как проверяешь результат: так проще найти причину, если следующая установка даст ошибку.

Источники и дальнейшее чтение

Материал описывает Oxide для Rust. Установка Carbon и других загрузчиков требует отдельной инструкции.