Skip to content

Конфигурация ​

Конфиг — это настройки функций, не код. Плагин создаёт его сам при первой успешной загрузке. Пока файл не появился, править нечего: сначала добейтесь строки Loaded plugin в консоли.

Нужны уже пройденные шаги: сервер, Oxide, плагин и синтаксис JSON.

Копия до правки

Скопируйте JSON рядом, например Vanish.json.bak, до того как менять значения. Сломанный файл Oxide не чинит: он либо не примет конфиг, либо перезапишет его значениями по умолчанию.

Где файл ​

Для Vanish из прошлого шага:

server/server1/oxide/config/Vanish.json

Имя файла совпадает с именем плагина. Открывайте его Sublime Text, не блокнотом Windows: блокнот легко сохраняет файл в кодировке, после которой кавычки превращаются в другие символы.

Чужой плагин с TopPlugin ляжет рядом, отдельным JSON. Не склеивайте два конфига в один файл.

Что внутри ​

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

json
{
  "NoClip on Vanish (runs noclip command)": true,
  "Automatically vanish players (with the vanish.use perm) on player connect": false,
  "Enable GUI": true,
  "Icon URL (.png or .jpg)": "https://i.ibb.co/3rZzftx/yL9HNRy.png",
  "Image Color": "1 1 1 0.3"
}

Ключ — длинная английская фраза. Её не переводят и не укорачивают: по ней плагин находит настройку. Меняется только значение справа.

Разберём типы на этом фрагменте:

  • true и false — включить полёт и автоневидимость при входе;
  • строка в кавычках — ссылка на картинку иконки;
  • "1 1 1 0.3" — тоже строка, хотя внутри цифры. Кавычки снимать нельзя, для плагина это цвет, а не число.

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

json
"Icon URL (.png or .jpg)": "https://example.com/vanish-icon.png",

Запятая после строки остаётся, если ниже есть ещё поля. Сохраните файл.

Как применить ​

В консоли сервера:

o.reload Vanish

Ждите повторное Loaded plugin Vanish. После этого зайдите на сервер и проверьте функцию. Пока нет права vanish.use, команда /vanish ответит, что доступа нет. Это не сломанный конфиг, права разбирает следующая статья.

Если после reload в консоли ошибка JSON, правка не применилась. Верните .bak и перенесите изменение ещё раз. Чаще всего виноваты умные кавычки, которые редактор подставил вместо " , или запятая в конце файла.

Новые ключи после обновления .cs сами в старый JSON не дописываются. Сверьте страницу плагина. Рабочий способ, если конфиг совсем старый: выгрузить плагин, убрать JSON в сторону, загрузить плагин, чтобы он создал свежий файл, и перенести свои значения по одному.

Опубликовано под лицензией MIT.
Данный проект не является официальной документацией Facepunch/Rust.
Это общественная база знаний, созданная для удобства администраторов и игроков.