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

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

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

Сервер Rust должен быть настроен, а Carbon установлен. Этот процесс описан в статьях настройка сервера и установка Carbon.

WARNING

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

Совместимость с Oxide

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

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

Вот надёжные источники платных и бесплатных плагинов:

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

DANGER

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

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

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

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

1. Конфигурацию - в папке carbon/configs
2. Локализацию - в папке carbon/lang
3. Дата-файлы - в папке carbon/data
4. Логи - в папке carbon/logs

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

Для примера возьмём бесплатный плагин невидимости для администраторов Vanish с сайта Umod.org.

Скачав плагин, вы получите файл Vanish.cs. Перенесите его в папку carbon/plugins и посмотрите в консоль сервера: Carbon сам заметит новый файл, скомпилирует и загрузит плагин. В консоли появится сообщение со словами Loaded plugin и названием плагина.

Проверить, что плагин работает, можно командой c.plugins: она выводит список загруженных плагинов.

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

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

Не удаляйте плагин и его файлы: они понадобятся в следующих статьях.

INFO

Carbon сам следит за папкой plugins: когда вы добавляете или заменяете файл, плагин загружается или перезагружается без перезапуска сервера.

Модуль Vanish

В Carbon есть встроенный модуль Vanish с той же чат-командой /vanish и тем же разрешением vanish.allow. По умолчанию он выключен. Не включайте его вместе с плагином Vanish, чтобы они не мешали друг другу.

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

1. c.reload Vanish - выгружает и снова загружает плагин. Нужна, чтобы применить изменения в конфигурации или локализации.
2. c.load Vanish - загружает плагин, если он ещё не загружен или вы его выгружали.
3. c.unload Vanish - выгружает плагин. Файл остаётся на сервере, но плагин не работает, пока вы снова не загрузите его командой c.load.
4. c.plugins - показывает список загруженных плагинов.

В командах загрузки можно перечислить несколько плагинов через пробел, а вместо названия указать звёздочку *, чтобы применить команду ко всем плагинам. Например, c.reload * перезагрузит все плагины.

Привычные команды Oxide

Команды o.reload, o.load и o.unload в Carbon не работают. Если вы к ним привыкли, добавьте замены в раздел Aliases файла carbon/config.json. Как это сделать, описано в статье переход с Oxide.

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

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

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

INFO

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

Заключение

Теперь вы умеете устанавливать и обновлять плагины. Дальше научимся их настраивать, но сначала прочитайте статью синтаксис JSON.