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

В этой статье мы установим первый плагин на ваш сервер и разберемся, что он создает и из чего состоит

Предварительные условия

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

WARNING

Если вы ещё не выполнили эти действия, пожалуйста, сделайте это, прежде чем продолжить.

Поиск плагинов

Существует множество источников, где вы можете найти плагины для своего сервера Rust.
Вот список надежных источников с платными и бесплатными плагинами :

1. Umod.org - официальный сайт модификации для вашего сервера, все плагины на нем бесплатные и от настоящих авторов
2. SkyPlugins.ru - маркетплейс-площадка с плагинами и дополнительными модификациями от опытных и официальных авторов
3. RustPlugin.ru - площадка по продаже плагинов для серверов RUST, является одной из площадок-старожилов с официальными авторами
4. CodeFling.com - зарубежная площадка по продаже различных модификаций, от официальных авторов
5. ChaosCode.io - зарубежная площадка-старожил по продаже различных модификаций, от официальных авторов
6. Lone.design - зарубежная площадка по продаже различных модификаций, от официальных авторов

DANGER

Пользуйтесь только проверенными источниками, которые указаны в этом списке, иначе вы можете потерять свои деньги и нарваться на мошенников
Если вы видите на других сайтах плагины или другие работы дешевле и этого сайте нет в данном списке - это очевидно мошенники, обходите их стороной

О файле плагина

Файл плагина - это исходный код, разработанный на языке программирования C#, поэтому после его скачивания, вы получаете файл в формате .cs
Некоторые разработчики прикрепляют к плагинам дополнительные файлы, например изображения, файлы с настройками и прочее, в некоторых случаях это требуется для более больших плагинов, в данной статье мы рассмотрим небольшой плагин

После установки плагина на сервер, он создаст дополнительные файлы, такие как :

1. Файл конфигурации - config
2. Файлы локализации - lang
3. Файл хранения данных - data
4. Файл для логирования - logs

Скачивание и установка первого плагина

В рамках данной статьи мы воспользуемся официальной площадкой модификации Umod.org и установим бесплатный плагин для обзора и обучения.
Для примера установим плагин для администраторов, на невидимость - Vanish

Скачав данный плагин - мы получаем файл с расширением .cs, в нашем случае полное название файла будет Vanish.cs
Для его установки - нам нужно будет перенести скачанный файл в папку oxide/plugins и посмотреть в серверную консоль.

Если вы видите такое сообщение в вашей серверной консоли, значит вы успешно установили свой первый плагин

[CSharp] Started Oxide.Compiler v1.0.32.0 successfully
Loaded plugin Vanish v1.9.1 by Whispers88
[Vanish] Load Data

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

1. Конфигурационный файл - oxide/config/Vanish.json в данном файле происходит вся настройка функций плагина
2. Локализация - oxide/lang/en/Vanish.json в данном файле расположены сообщения от плагина или любой другой текст, который можно перевести на разные языки
   В данный момент мы имеем файл на английском языке под английскую локализацию, она будет как на русском клиенте игры работать, так и на других, связано это с отсутствием других файлов локализации для этого плагина.
3. Хранилище данных - oxide/data/VanishPlayers.json - это системный файл плагина для хранения данных, в нем находятся временные и другие данные связанные с работой этого плагина

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

WARNING

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

Команды Oxide для работы с плагинами

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

1. oxide.reload PluginName - эта команда выгружает, а затем загружает указанный плагин.
   Это полезно, если вы обновили конфигурацию плагина и хотите, чтобы изменения вступили в силу.
2. oxide.load PluginName - эта команда загрузит указанный плагин, если он ещё не загружен или вы его выгружали.
3. oxide.unload PluginName - эта команда выгрузит указанный плагин.
   Файл плагина все так-же останется на сервере, но не будет функционировать, пока вы его не загрузите

INFO

Это базовые и основные команды для работы с плагином, так как после любых изменений в конфигурации плагина или в его локализации - вам потребуется перезагрузить плагин

Обновление плагинов

Регулярное обновление плагинов гарантирует, что вы получите последние версии и исправления ошибок от разработчика плагина.
Процесс обновления практически идентичен процессу установки:

1. Скачайте обновлённый плагин: обычно последнюю версию плагина можно найти на том же сайте, где вы скачали оригинальный плагин.
   Как и в случае с установкой, убедитесь, что вы скачиваете плагин из надёжного источника.
2. Замените старый файл плагина: после загрузки обновленной версии плагина вам нужно заменить старый файл плагина на вашем сервере на новый.
   Oxide автоматически обнаружит обновленный файл и перезагрузит плагин.
3. Проверьте обновление плагина: вы можете проверить, что плагин обновился, просмотрев в консоли сервера сообщение о перезагрузке плагина.

INFO

После обновления плагина, в файлах от плагина, например в конфигурации, могут появиться новые пункты с настройками, об этих изменениях нужно будет читать на странице плагина, откуда вы его скачали

Заключение

Теперь, когда вы узнали, как устанавливать и обновлять плагины на сервере Rust, следующий шаг - научиться настраивать их в соответствии с потребностями вашего сервера
Для этого переходите к следующим статьям постепенно, шаг за шагом