Цей посібник описує, як встановити фреймворк для модифікацій Oxide/uMod або Carbon на ваш сервер Rust, додати плагіни спільноти та керувати ними через консоль. Загальну інформацію про налаштування сервера та змінні запуску дивіться в Посібнику з налаштування сервера Rust.
Встановлення Oxide/uMod або Carbon
Oxide (який зараз підтримується під назвою uMod) і Carbon — це фреймворки для модифікацій Rust, які дозволяють встановлювати плагіни, створені спільнотою. Ці фреймворки додають такі можливості, як економічні системи, користувацькі набори, нагороди за голосування, зони захисту PvE та багато іншого.
Вам не потрібно завантажувати жодних файлів вручну. Фреймворк для модифікацій встановлюється автоматично шляхом задання однієї змінної запуску:
- Зупиніть свій сервер на вкладці Console в GPanel.
- Увійдіть до GPanel і перейдіть на вкладку Startup.
- Знайдіть змінну
FRAMEWORKі встановіть для неї значення:oxide— для Oxide/uMod (найпоширеніший фреймворк із найбільшою бібліотекою плагінів)carbon— для фреймворку Carbon (альтернатива з власною екосистемою плагінів)vanilla— для запуску без будь-якого фреймворку модифікацій
- Запустіть сервер. Файли фреймворку завантажуються та застосовуються автоматично. Під час першого запуску з Oxide створюється структура каталогів
oxide/. - Перевірте журнал консолі на наявність рядка на кшталт
Loaded plugin Oxide.Core, щоб підтвердити, що Oxide активний.
FRAMEWORK і запускаєте сервер, фреймворк завантажується та встановлюється автоматично. Вам не потрібно завантажувати файли Oxide або Carbon через SFTP.
Встановлення плагінів
Плагіни розповсюджуються як файли .cs (вихідний код C#). Oxide компілює їх на сервері під час виконання — попередня компіляція не потрібна.
- Завантажте файл плагіна
.csіз umod.org або іншого надійного джерела. - Завантажте файл
.csдо каталогуoxide/plugins/на вашому сервері за допомогою SFTP або файлового менеджера GPanel. Допомогу щодо SFTP дивіться в статті Як завантажувати файли через SFTP. - Якщо сервер запущений, плагін буде виявлено та скомпільовано автоматично протягом кількох секунд. Ви побачите в консолі повідомлення, що підтверджує його завантаження, наприклад
Loaded plugin MyPlugin v1.2.3 by Author. - Якщо сервер не запущений, плагін завантажиться під час наступного запуску.
Структура каталогів 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
oxide/plugins/. Файли, розміщені у підкаталогах або з неправильним розширенням, ігноруватимуться. Кожен плагін повинен мати розширення .cs.
Налаштування плагінів
Більшість плагінів під час першого завантаження генерують файл конфігурації JSON у каталозі oxide/config/. Щоб налаштувати плагін:
- Дозвольте плагіну завантажитися хоча б один раз, щоб він згенерував стандартний файл конфігурації.
- Зупиніть сервер (або врахуйте, що деякі плагіни підтримують перезавантаження конфігурації на льоту).
- Відкрийте файл конфігурації плагіна в
oxide/config/PluginName.jsonза допомогою файлового менеджера GPanel або SFTP. - Відредагуйте налаштування та збережіть файл.
- Перезавантажте плагін командою
oxide.reload PluginNameабо перезапустіть сервер.
Керування плагінами через консоль
Ці команди можна виконувати з консолі GPanel або через клієнт RCON. Щодо налаштування RCON дивіться статтю Доступ до RCON та адмін-команди Rust.
| Команда | Опис |
|---|---|
oxide.plugins |
Перелічити всі наразі завантажені плагіни та їхні версії. |
oxide.load PluginName |
Завантажити плагін, який присутній у oxide/plugins/, але ще не завантажений. |
oxide.unload PluginName |
Вивантажити плагін без видалення файлу. |
oxide.reload PluginName |
Перезавантажити плагін після оновлення його файлу .cs. Використовуйте це, щоб застосувати оновлення плагінів без повного перезапуску сервера. |
oxide.reload * |
Перезавантажити всі завантажені плагіни одночасно. |
Оновлення плагінів
Щоб оновити плагін до новішої версії:
- Завантажте оновлений файл
.csзі сторінки плагіна на umod.org. - Завантажте новий файл до
oxide/plugins/, перезаписавши наявний файл. - Якщо сервер запущений, Oxide виявляє зміну файлу та автоматично перекомпільовує й перезавантажує плагін. Як альтернативу, виконайте
oxide.reload PluginName. - Перевірте консоль на наявність помилок. Деякі оновлення плагінів можуть потребувати змін у файлі конфігурації в
oxide/config/.
Видалення плагінів
Щоб повністю видалити плагін:
- Виконайте
oxide.unload PluginName, щоб вивантажити плагін, поки сервер запущений. - Видаліть файл
.csізoxide/plugins/. - За бажанням видаліть файл конфігурації плагіна з
oxide/config/та файли даних ізoxide/data/, якщо вони вам більше не потрібні.
Популярні плагіни
| Плагін | Категорія | Опис |
|---|---|---|
| Kits | Геймплей | Дозволяє гравцям отримувати попередньо налаштовані набори предметів. Корисно для стартових наборів або VIP-нагород. |
| Economics | Економіка | Додає систему серверної валюти. Використовується як залежність багатьма плагінами магазинів і нагород. |
| ServerRewards | Економіка | Система нагород на основі балів, часто поєднується з Economics для внутрішньоігрового магазину. |
| VoteDay | Утиліта | Дозволяє гравцям голосувати за перехід до денного часу. Зменшує скарги на довгі ночі. |
| Clans | Соціальне | Додає систему кланів/команд із клановими тегами та спільним доступом до шафок з інструментами. |
| TruePVE | PvE | Запобігає шкоді між гравцями. Незамінний для конфігурацій серверів PvE. |
| Teleportation | Утиліта | Додає команди телепортації між гравцями та до домівки з налаштовуваними часами очікування. |
| DiscordCore / DiscordMessages | Інтеграція | Надсилає серверні події (підключення, чат, смерті) до каналу Discord через вебхук. |
Усунення проблем із плагінами
Якщо ваші плагіни не завантажуються, перевірте таке:
- Переконайтеся, що Oxide встановлено та активовано. На вкладці Startup у GPanel змінна
FRAMEWORKмає бути встановлена вoxide. У журналі консолі під час запуску має відображатисяLoaded plugin Oxide.Core. - Файли плагінів мають розміщуватися безпосередньо в
oxide/plugins/з точним розширенням.cs. Файли у підкаталогах або з неправильним розширенням ігноруються. - Перевірте консоль і
oxide/logs/на наявність помилок компіляції. Плагін із синтаксичною помилкою не завантажиться, і повідомлення про помилку опише проблему. - Деякі плагіни мають залежності від інших плагінів (наприклад, багато плагінів магазинів потребують Economics). Спочатку встановіть усі необхідні залежності.
Щодо інших поширених проблем із сервером дивіться статтю Усунення несправностей сервера Rust.
Потрібна допомога?
Якщо ви зіткнулися з проблемою, не описаною в цьому посібнику, наша команда підтримки готова допомогти. Надішліть запит у службу підтримки і вкажіть ID вашого сервера, опис проблеми та будь-який відповідний вивід консолі.