Конфигурация плагина

Конфигурация плагина отвечает за настройку его функций. Перед этой статьёй обязательно прочитайте синтаксис JSON.

WARNING

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

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

1. Сервер Rust создан и запускается. Если нет, прочитайте статью создание сервера.
2. На сервере установлен Carbon. Если нет, прочитайте статью установка Carbon.
3. На сервере установлен хотя бы один плагин. Если нет, прочитайте статью установка плагинов.

Где лежат конфигурации плагинов

Конфигурации плагинов хранятся в папке carbon/configs в формате JSON. Плагин создаёт свой файл при первой загрузке, если файла ещё нет.

Если вы шли по статьям по порядку, в этой папке будет файл Vanish.json от плагина Vanish, который мы установили ранее. Откройте его в Sublime Text.

Отличие от Oxide

В Oxide конфигурации лежат в папке oxide/config, а в Carbon - в carbon/configs. Если переносите плагины с Oxide, копируйте конфигурации именно в configs.

Пример конфигурации Vanish

Так выглядит конфигурация плагина Vanish версии 2.1.5 со значениями по умолчанию. В других версиях набор настроек может отличаться. Бывают и конфигурации на русском языке, это зависит от автора и площадки, где вы взяли плагин.

{
  "NoClip on Vanish (runs noclip command)": true,
  "Inventory view cmd": [
    "inv",
    "invspy"
  ],
  "Use OnEntityTakeDamage hook (Set to true to enable use of vanish.damage perm. Set to false for better performance)": false,
  "Use CanUseLockedEntity hook (Allows vanished players with the perm vanish.unlock to bypass locks. Set to false for better performance)": true,
  "Automatically vanish players (with the vanish.use perm) on player connect": false,
  "Automatically vanish players (with the vanish.use perm) on player disconnect": false,
  "Keep a vanished player hidden on disconnect": true,
  "Teleport a vanished player under the map on disconnect": false,
  "Teleport a vanished player above the map on connect": true,
  "Bypass violation checks for vanished players": true,
  "Turn off fly hack detection for players in vanish": true,
  "Disable metabolism in vanish": true,
  "Enable teleport to marker when vanished": false,
  "Enable vanishing and reappearing sound effects": true,
  "Make sound effects public": false,
  "Enable chat notifications": true,
  "Sound effect to use when vanishing": "assets/prefabs/npc/patrol helicopter/effects/rocket_fire.prefab",
  "Sound effect to use when reappearing": "assets/prefabs/npc/patrol helicopter/effects/rocket_fire.prefab",
  "Enable GUI": true,
  "Use Native Invis Icon": false,
  "Icon URL (.png or .jpg)": "https://i.ibb.co/3rZzftx/yL9HNRy.png",
  "Icon Sprite": "assets/icons/refresh.png",
  "Image Color": "1 1 1 0.5",
  "Image AnchorMin": "0.175 0.017",
  "Image AnchorMax": "0.22 0.08"
}

Для примера заменим картинку, которую плагин показывает на экране. За неё отвечает выделенная строка Icon URL (.png or .jpg), а сама картинка показывается, пока включена настройка Enable GUI.

Из статьи синтаксис JSON мы помним, что значение этой настройки - строка, поэтому ссылка пишется в кавычках "". Замените ссылку на новую и сохраните файл:

"Icon URL (.png or .jpg)": "https://i.ibb.co/JWDhYTmC/invisible-man-1.png",

Применяем изменения

Чтобы настройки вступили в силу, перезагрузите плагин командой в консоли сервера: c.reload Vanish.

Эту команду мы разбирали в статье установка плагинов.

TIP

В Carbon есть и команда c.reloadconfig, которая перечитывает только конфигурацию плагина. Разработчики Carbon предупреждают, что она может работать непредсказуемо, поэтому надёжнее перезагружать плагин целиком через c.reload.

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

Настройки самого Carbon

У Carbon есть собственный файл настроек carbon/config.json. Для первого сервера его менять не нужно, но полезно знать основные разделы:

Раздел	Что настраивает
IsModded	помечает сервер как модифицированный, чтобы он отображался во вкладке Modded браузера серверов
Prefixes	префиксы чат-команд, по умолчанию /
Aliases	замены команд, например o.reload на c.reload
Language	язык сервера для локализации плагинов, по умолчанию en
Watchers	слежение за папками: пока включён ScriptWatchers, Carbon сам подхватывает изменения в плагинах
Permissions	названия групп по умолчанию и автоматическая выдача групп
SelfUpdating	автообновление Carbon при запуске сервера
Logging	настройки логов

После правки config.json перезапустите сервер или выполните c.loadconfig, чтобы Carbon перечитал файл.

CarbonAuto

Carbon добавляет собственные серверные переменные с префиксом c., например c.craftingspeedmultiplier_nowb. Их можно менять командами в консоли, в файле carbon/config.auto.json или в панели администратора. Полный список есть в справочнике Carbon.