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

Плагин — это файл .cs, исходник на C#. Oxide сам компилирует его при появлении в папке и при замене файла. Отдельно ставить Visual Studio на сервер не нужно.

Сервер должен уже запускаться с Oxide. Если oxide.version в консоли неизвестна, вернитесь к установке Oxide.

Откуда скачивать

Файл берите там, где его выложил автор.

• TopPlugin — плагины, с которыми связан этот курс. В карточке написано, под какой фреймворк сборка и какие права она просит.
• umod.org/plugins — бесплатный каталог Oxide, файлы публикуют сами авторы.
• Крупные зарубежные площадки вроде Codefling, Chaos, Lone Design и русские магазины вроде RustPlugin. Ими пользуются, если автор продаёт плагин именно там.

Случайный архив «тот же плагин, но дешевле» с незнакомого сайта часто содержит чужой код. Если площадки нет в карточке автора, не оплачивайте её. Бесплатный плагин с uMod не становится «лицензией», когда его перепродают.

Что появится после загрузки

Помимо самого .cs плагин обычно создаёт:

Файл	Папка
настройки	oxide/config
тексты	oxide/lang
сохранения	oxide/data
журнал	oxide/logs

Путь всегда внутри идентичности. Для наших примеров это server/server1/oxide/....

Первый плагин

Для курса возьмём бесплатный Vanish с uMod: невидимость для администратора, мало настроек, на нём удобно учиться. Скачанный файл называется Vanish.cs.

Положите его в:

C:\rust-server\server\server1\oxide\plugins

Сервер в этот момент может работать. Останавливать его не нужно: Oxide замечает новый файл и компилирует сам. В консоли появляется что-то вроде Loaded plugin Vanish и номер версии. Точные цифры зависят от сборки, важен сам факт загрузки, а не номер из чужого скриншота.

Дальше на диске будут:

• server/server1/oxide/config/Vanish.json — настройки;
• server/server1/oxide/lang/en/Vanish.json — английские фразы, их увидят все, пока нет файла ru;
• server/server1/oxide/data/VanishPlayers.json — кого плагин запомнил.

Не удаляйте эти файлы до конца курса: следующие статьи правят именно их.

Если в консоли красная ошибка компиляции, плагин не загрузился. Читайте первую строку ошибки, а не хвост. Частая причина — файл положили в корневой oxide/plugins, а сервер читает server/server1/oxide/plugins.

Сервер перезапускать не надо

Смена .cs, конфига и языка подхватывается перезагрузкой плагина. Полный рестарт нужен после обновления самой игры и после установки Oxide, не после каждого плагина.

Команды загрузки

Имя — это название файла без .cs.

o.reload Vanish
o.load Vanish
o.unload Vanish
o.plugins

reload выгружает и сразу читает файл с диска. Её выполняют после правки JSON и после замены .cs, если автоперезагрузка не сработала. unload выключает плагин, но файл на диске остаётся. load включает его обратно. o.plugins печатает, что сейчас в памяти.

Длинная форма тех же команд — oxide.reload, oxide.load, oxide.unload.

Обновление

1. Скачайте новую версию с той же страницы, откуда брали файл.
2. Замените Vanish.cs в plugins. Имя файла не переименовывайте: Oxide считает имя файла именем плагина.
3. В консоли должна появиться повторная загрузка.

Новая версия часто дописывает ключи в Vanish.json. Старый конфиг при этом не всегда обновляется сам. Сверьте описание на странице плагина. Если плагин сбросился на значения по умолчанию, у него был сломан JSON: запятая, кавычка или чужой ключ. Как это устроено — в следующей статье.

Плагины с TopPlugin ставятся так же. Отличается только место, где вы скачали .cs, и список прав в карточке.