Skip to content

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

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

WARNING

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

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

Прежде чем мы начнем, убедитесь, что у вас есть следующее:

  1. Рабочий сервер Rust настроен и запущен.
    Если вы еще не сделали это, читайте статьи : создание сервера
  2. Oxide установлен на вашем сервере.
    Если вы еще не сделали это, читайте статьи : установка Oxide
  3. На вашем сервере должен быть установлен хотя бы один плагин.
    Если вы еще не сделали это, читайте статьи : установка плагинов

Понимание конфигурационных файлов

Файлы конфигурации, создаются в каталоге /oxide/config при каждой загрузке плагина на сервер.
В этих файлах хранятся настройки плагинов в формате JSON.

Перед прочтениеим данной статьи - вы должны ознакомиться с синтаксис JSON, если еще не сделали этого

Найти файлы конфигурации мы можем по пути /oxide/config, если вы следовали инструкциям, то у вас будет один конфигурационный файл Vanish.json, от плагина Vanish, который мы установили ранее
Открывается данный файл с помощью SublimeText

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

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

json
{
  "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": true,
  "Automatically vanish players (with the vanish.use perm) on player disconnect": true,
  "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,
  "Reset hydration and health on un-vanishing (resets to pre-vanished state)": true,
  "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,
  "Icon URL (.png or .jpg)": "https://i.ibb.co/3rZzftx/yL9HNRy.png",
  "Image Color": "1 1 1 0.3",
  "Image AnchorMin": "0.175 0.017",
  "Image AnchorMax": "0.22 0.08"
}

Вы можете заменять значения на свое усмотрение и свои пожелания, давайте для примера заменить ссылку на картинку для плагина.
Мы возьмем новую картинку и заменим старую, вот прямая ссылка на новую картинку https://i.ibb.co/JWDhYTmC/invisible-man-1.png, вы можете заранее перейти по ней и посмотреть на нее.

json
{
  "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": true,
  "Automatically vanish players (with the vanish.use perm) on player disconnect": true,
  "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,
  "Reset hydration and health on un-vanishing (resets to pre-vanished state)": true,
  "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,
  "Icon URL (.png or .jpg)": "https://i.ibb.co/3rZzftx/yL9HNRy.png", 
  "Image Color": "1 1 1 0.3",
  "Image AnchorMin": "0.175 0.017",
  "Image AnchorMax": "0.22 0.08"
}

Итак, вы можете наблюдать выделенное поле с пунктом в конфигурации, отвечающее за изображение в плагине
Если вспомнить урок синтаксис JSON, мы можем видеть, что значение в этой настройке является строкой, значит должно быть заключено в кавычки ""
Заменим текущую ссылку на нашу и сохраним файл.

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

После перезагрузки, мы увидим сообщение в консоли :

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

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

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