Короткий ответ
Загружайте файлы плагинов .cs в oxide/plugins. Их настройки
появляются в oxide/config после первого запуска. Используйте
oxide.reload PluginName, чтобы применить изменения без перезапуска, и выдавайте
права группам через oxide.grant group (GROUP) (PERMISSION), а не отдельным людям.
Ключевые моменты
- Три папки: plugins, config, data. У каждой одна задача.
- Файлы конфигурации появляются только после того, как плагин запустился один раз. Не создавайте их вручную.
oxide.reloadлучше перезапуска почти для любого изменения плагина.- Выдавайте права группам, а не людям. Это масштабируется и поддаётся аудиту.
- Документация каждого плагина перечисляет его права. Читайте её, а не гадайте.
Три папки
uMod создаёт три папки на вашем сервере, и знание того, что делает каждая, избавит вас от путаницы в дальнейшем.
oxide/plugins- Сами файлы плагинов, в виде
.cs. Помещение файла сюда загружает его автоматически. oxide/config- Файлы конфигурации для большинства плагинов. Они создаются плагином при первом запуске, а не предоставляются вами.
oxide/data- Хранимые данные, которые некоторые плагины сохраняют между перезапусками, например записи об игроках или баланс экономики. Относитесь к этому как к памяти плагина, а не к тому, что можно редактировать по случаю.
Отсутствующий файл конфигурации не проблема, которую нужно чинить. Если вы только что
загрузили плагин, а в oxide/config для него ничего нет, это потому, что плагин
ещё не запускался. Запустите сервер, дайте ему загрузиться, и файл появится.
Загрузка плагинов
-
Получите файл плагина
Скачайте файл
.csиз библиотеки плагинов uMod или откуда бы его ни распространял автор. -
Загрузите его в oxide/plugins
Через файловый менеджер или по FTP. Загружайте сам файл
.cs, а не его zip-архив. -
Дайте ему загрузиться
uMod подхватывает новые файлы автоматически. Следите за консолью на предмет подтверждения загрузки или ошибки.
-
Настройте его
Его файл конфигурации теперь будет существовать в
oxide/config. Отредактируйте его, затем выполнитеoxide.reload PluginName, чтобы применить.
Каждый плагин на сайте uMod сопровождается описанием, охватывающим его настройку, параметры конфигурации и права, которые он определяет. Прочитайте эту страницу, прежде чем начать гадать с настройками, потому что большинство вопросов, которые у вас вот-вот появятся, там уже отвечены.
Команды, которые вам нужны
| Команда | Что она делает |
|---|---|
oxide.reload (PLUGIN NAME) | Перезагружает указанный плагин. |
oxide.unload (PLUGIN NAME) | Выгружает указанный плагин. |
oxide.reload * | Перезагружает все плагины сразу. |
oxide.usergroup add (GROUP NAME) | Создаёт новую группу пользователей Oxide. |
oxide.grant group (GROUP NAME) (PERMISSION) | Выдаёт право группе. |
oxide.grant user (USERNAME/STEAM64 ID) (PERMISSION) | Выдаёт право одному пользователю. |
oxide.reload это команда, которая меняет ваш подход к работе. Редактирование
конфигурации и перезагрузка одного плагина занимает секунды и никого не отключает.
Перезапуск сервера ради того же результата обходится вашим игрокам загрузкой карты и, если
сид изменился, до десяти минут ожидания.
Группы прав на практике
Права Oxide можно выдать отдельному пользователю или группе. Оба варианта работают. Используйте группы.
Причина в обслуживании. Выдайте десять прав напрямую пяти VIP, и у вас будет пятьдесят выдач,
за которыми нужно следить, а когда кто-то перестаёт быть VIP, вам придётся вспомнить все десять.
Выдайте десять прав группе VIPs, и добавление или удаление человека это одна
команда.
-
Создайте группу
oxide.usergroup add VIPs -
Выдайте группе её права
oxide.grant group VIPs kits.vip -
Добавьте людей в группу
Вместо того чтобы выдавать им права по отдельности. Их доступ затем следует определению группы.
Разобранные примеры
- Перезагрузить плагин, который вы только что обновили
- Вы заменили файл BetterChat, поэтому выполните
oxide.reload BetterChat. Перезапуск не нужен. - Дать админам noclip
oxide.grant group Admins noclip.useдаёт это право всем в группе Admins.- Создать VIP уровень
oxide.usergroup add VIPs, затем выдайте ей всё, что должно входить в платный уровень.- Выдать одному человеку что-то временно
oxide.grant user 76561198000000000 kits.event. Используйте это экономно и помните, что вы это выдали.- Выключить плагин, который ведёт себя плохо, прямо сейчас
oxide.unload PluginName. Быстрее и менее разрушительно, чем перезапуск, и сразу скажет вам, был ли этот плагин проблемой.
Привычки, которые стоит завести
- Делайте резервную копию перед изменением плагинов
- Скопируйте
oxide/перед добавлением или удалением чего-либо. Восстановить папку быстрее, чем восстанавливать конфигурацию по памяти. - Добавляйте по одному плагину за раз
- Добавьте, перезагрузите, понаблюдайте за консолью и FPS сервера, затем переходите дальше. Добавив шесть сразу и обнаружив, что сервер недоволен, вы получите шесть подозреваемых.
- Следите за производительностью по ходу дела
- Плагины главный фактор влияния на производительность сервера Rust, и плагин, который выглядит незначительным, всё равно может стоить вам каждый тик.
- Держите плагины обновлёнными
- Проверяйте uMod после каждого обновления Rust. Устаревший плагин не компилируется, и ошибка называет его, что хотя бы легко диагностировать.
- Читайте консоль
- uMod необычайно хорошо сообщает, что пошло не так. Большинство проблем с плагинами уже объяснены в выводе, который вы ещё не прокрутили и не прочитали.
Для более глубокого понимания самого фреймворка официальная документация uMod является авторитетным источником. Если вы ещё не установили его, начните с нашего руководства по установке uMod на сервер Rust.