Как установить плагин Rust вручную через Oxide

Разберёмся, как установить плагин Rust без всяких автоустановщиков — просто файлом. Процедура занимает минуту, но вокруг неё крутится половина всех вопросов новичков: плагин не грузится, конфиг не появляется, команда не работает, в консоли непонятная ошибка компиляции. Все эти случаи имеют по одной типовой причине.

Предполагаю, что Oxide уже стоит и oxide.version отвечает. Для Carbon всё то же самое, только папка называется carbon, а команды идут с префиксом c..

Где брать плагины

Основные источники:

Оба первых каталога рекомендует документация Oxide по установке плагинов.

Скачивать со случайных форумов и Telegram-каналов не советую. Плагин — это исполняемый C#-код с полным доступом к серверу: он может читать файлы, ходить в сеть и делать что угодно с базой игроков. Скачанный из мутного источника «бесплатный аналог» платного плагина регулярно оказывается с сюрпризом.

Как установить плагин Rust: сама процедура

1. Скачайте файл. Он должен иметь расширение .cs — это исходник на C#, который Oxide скомпилирует сам.
2. Подключитесь к серверу по SFTP или откройте файловый менеджер в панели. Если с SFTP не работали, вот короткая инструкция.
3. Положите файл в oxide/plugins/.
4. Ничего не перезапускайте. Oxide следит за папкой и подхватывает новые файлы автоматически, обычно за пару секунд.

В консоли появится строка вида:

Loaded plugin Kits v4.3.1 by k1lly0u

Если автозагрузка отключена или вы не хотите ждать:

oxide.load Kits

Имя пишется без расширения и с точным регистром — Kits, а не kits.cs.

Проверить список загруженного:

oxide.plugins

Вывод покажет имя, версию, автора и время компиляции каждого плагина. Плагины с ошибками там отмечены отдельно.

Конфиг появляется после первого запуска

Частый вопрос: «положил плагин, а настроек нет». Конфигурационный файл создаётся плагином при первой загрузке, а не лежит в архиве. Ищите его в:

oxide/config/Kits.json

Правите файл, сохраняете, применяете:

oxide.reload Kits

Перезапускать сервер ради конфига не нужно — это одна из главных причин, по которой Oxide вообще удобен.

Важно: JSON капризен к синтаксису. Лишняя запятая перед закрывающей скобкой или кавычка не того типа — и плагин не загрузится, а в логе будет ошибка парсинга. Правьте конфиги в нормальном редакторе с подсветкой, а не в блокноте.

Данные плагина (кулдауны, выданные наборы, статистика) лежат отдельно, в oxide/data/. При вайпе чистят именно их, а конфиги оставляют — подробности в заметке про вайп сервера.

Права

Большинство плагинов после установки не делает ничего, пока вы не раздадите разрешения. Названия обычно выглядят как имяплагина.use:

oxide.grant group default kits.use
oxide.grant group vip kits.vip
oxide.grant user 76561198000000000 kits.admin

Посмотреть, какие разрешения регистрирует конкретный плагин:

oxide.show perms Kits

Забытые права — причина примерно половины сообщений «плагин установлен, но команда не работает». Система групп разобрана в отдельной заметке.

Зависимости и расширения

Некоторые плагины требуют других. Классические зависимости:

• ImageLibrary — нужен всему, что рисует иконки в интерфейсе: магазины, меню, наборы.
• Economics или ServerRewards — валюта, на которой строятся магазины.
• Clans — многие плагины проверяют клановую принадлежность.

Если зависимости нет, в консоли будет прямое сообщение вида Kits requires ImageLibrary to be installed. Ставится она так же, файлом в ту же папку.

Отдельная категория — расширения Oxide: это уже скомпилированные .dll, которые кладутся в RustDedicated_Data/Managed/ и требуют перезапуска сервера. Их немного, но, например, поддержка MySQL в некоторых плагинах приходит именно так.

Обновление и удаление

Обновление — просто замена файла новой версией. Oxide заметит изменение и перекомпилирует плагин на лету. Конфиг при этом сохраняется, а новые опции дописываются в него автоматически (у аккуратно написанных плагинов).

Удаление в два шага:

oxide.unload Kits

и потом удалить файл из oxide/plugins/. Если сделать наоборот, плагин останется висеть в памяти до перезапуска.

Конфиг и данные после удаления файла остаются на диске. Иногда это спасает — вернули плагин, всё на месте. Иногда мешает: старый конфиг несовместимой версии ломает новый плагин. Тогда переименуйте oxide/config/Kits.json и дайте плагину создать свежий.

Частые вопросы

Почему плагин не появляется в oxide.plugins?

Проверьте расширение файла. Браузеры любят сохранять Kits.cs как Kits.cs.txt, и в файловом менеджере это не всегда видно, потому что расширения скрыты. Второе — файл должен лежать именно в oxide/plugins/, а не в корне и не в подпапке.

Что значит ошибка компиляции с указанием строки?

Плагин несовместим с текущей версией Rust или Oxide. После месячного патча это нормальная ситуация: ждите обновления от автора. Если патча не было, значит вы скачали версию под другую платформу — проверьте, что это плагин для Rust, а не для другой игры на uMod.

Почему плагин загрузился, но команда в игре не работает?

Три кандидата по убыванию частоты: не выданы права, команда пишется в чат через /, а вы вводите её в F1-консоль (или наоборот), плагин требует зависимость и работает наполовину. Смотрите oxide/logs/ за нужную дату — там пишутся ошибки конкретного плагина.

Что делать, если сервер стал лагать после установки?

Выгружайте плагины по одному через oxide.unload и смотрите на серверный FPS в status. У Carbon для этого есть встроенный профайлер, у Oxide — плагины-профилировщики. Особенно подозрительны те, что работают на каждом кадре или на каждом движении игрока.

Итог

Схема простая: скачать .cs из нормального источника, положить в oxide/plugins/, дождаться загрузки, поправить конфиг в oxide/config/, сделать oxide.reload, выдать права. Если что-то не работает — сначала расширение файла, потом права, потом логи.

Подборка плагинов, с которых стоит начать новому серверу, собрана в обзоре. А если нужен сервер, где Oxide и файловый менеджер уже готовы из коробки, — тарифы под Rust здесь.