Това ръководство обхваща как да инсталирате моддинг рамката Oxide/uMod или Carbon на вашия Rust сървър, да добавяте плъгини от общността и да ги управлявате чрез конзолата. За обща конфигурация на сървъра и стартови променливи, вижте Ръководство за конфигурация на Rust сървър.

Инсталиране на Oxide/uMod или Carbon

Oxide (сега поддържан като uMod) и Carbon са моддинг рамки за Rust, които ви позволяват да инсталирате плъгини, създадени от общността. Тези рамки добавят функции като икономически системи, потребителски комплекти, награди за гласуване, PvE защитени зони и много повече.

Не е необходимо да качвате файлове ръчно. Моддинг рамката се инсталира автоматично чрез задаване на една стартова променлива:

1. Спрете сървъра си от раздела Console в GPanel.
2. Влезте в GPanel и отидете в раздела Startup.
3. Намерете променливата FRAMEWORK и я задайте на:
   • oxide — за Oxide/uMod (най-широко използваната рамка, с най-голямата библиотека от плъгини)
   • carbon — за рамката Carbon (алтернатива със собствена екосистема от плъгини)
   • vanilla — за работа без моддинг рамка
4. Стартирайте сървъра. Файловете на рамката се изтеглят и прилагат автоматично. При първото стартиране с Oxide се генерира структурата на директорията oxide/.
5. Проверете лога на конзолата за ред като Loaded plugin Oxide.Core, за да потвърдите, че Oxide е активен.

Инсталиране на плъгини

Плъгините се разпространяват като .cs (C# source) файлове. Oxide ги компилира на сървъра по време на изпълнение — не се изисква предварително компилиране.

1. Изтеглете .cs файла на плъгина от umod.org или друг доверен източник.
2. Качете .cs файла в директорията oxide/plugins/ на вашия сървър чрез SFTP или файловия мениджър на GPanel. За помощ с SFTP, вижте Как да качвате файлове чрез SFTP.
3. Ако сървърът работи, плъгинът ще бъде открит и компилиран автоматично в рамките на няколко секунди. Ще видите изход в конзолата, потвърждаващ зареждането, напр. Loaded plugin MyPlugin v1.2.3 by Author.
4. Ако сървърът не работи, плъгинът ще се зареди при следващото стартиране.

Структура на директорията Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

Конфигуриране на плъгини

Повечето плъгини генерират JSON конфигурационен файл в oxide/config/ при първото си зареждане. За да персонализирате плъгин:

1. Оставете плъгина да се зареди поне веднъж, за да генерира своя файл с конфигурация по подразбиране.
2. Спрете сървъра си (или имайте предвид, че някои плъгини поддържат презареждане на конфигурацията на живо).
3. Отворете конфигурационния файл на плъгина в oxide/config/PluginName.json с помощта на файловия мениджър на GPanel или SFTP.
4. Редактирайте настройките и запазете файла.
5. Презаредете плъгина с oxide.reload PluginName или рестартирайте сървъра.

Управление на плъгини чрез конзолата

Тези команди могат да се изпълняват от конзолата на GPanel или чрез RCON клиент. За настройка на RCON, вижте RCON достъп и админ команди за Rust.

Актуализиране на плъгини

За да актуализирате плъгин до по-нова версия:

1. Изтеглете актуализирания .cs файл от страницата на плъгина на umod.org.
2. Качете новия файл в oxide/plugins/, презаписвайки съществуващия файл.
3. Ако сървърът работи, Oxide открива промяната на файла и автоматично прекомпилира и презарежда плъгина. Алтернативно, изпълнете oxide.reload PluginName.
4. Проверете конзолата за грешки. Някои актуализации на плъгини може да изискват промени в конфигурационния файл в oxide/config/.

Премахване на плъгини

За да премахнете плъгин напълно:

1. Изпълнете oxide.unload PluginName, за да разтоварите плъгина, докато сървърът работи.
2. Изтрийте .cs файла от oxide/plugins/.
3. По избор изтрийте конфигурационния файл на плъгина от oxide/config/ и файловете с данни от oxide/data/, ако вече не са ви необходими.

Популярни плъгини

Отстраняване на проблеми с плъгини

Ако вашите плъгини не се зареждат, проверете следното:

• Потвърдете, че Oxide е инсталиран и активен. В раздела Startup на GPanel променливата FRAMEWORK трябва да е зададена на oxide. Логът на конзолата трябва да показва Loaded plugin Oxide.Core по време на стартиране.
• Файловете на плъгините трябва да се поставят директно в oxide/plugins/ с точното разширение .cs. Файловете в поддиректории или с грешни разширения се игнорират.
• Проверете конзолата и oxide/logs/ за грешки при компилация. Плъгин със синтактична грешка няма да се зареди и съобщението за грешка ще опише проблема.
• Някои плъгини имат зависимости от други плъгини (напр. много плъгини за магазини изискват Economics). Първо инсталирайте всички необходими зависимости.

За други чести проблеми със сървъра, вижте Отстраняване на проблеми с Rust сървър.

Нуждаете се от помощ?

Ако се сблъскате с проблем, който не е обхванат в това ръководство, нашият екип за поддръжка е на разположение, за да помогне. Изпратете тикет за поддръжка и включете вашия идентификатор на сървъра, описание на проблема и всякакъв релевантен изход от конзолата.