Тонкости администрирования сервера uMod или Oxide

Начало

Введение

Требования к серверу

Требования к платформе uMod варьируются в зависимости от игрового сервера.

Дополнительную информацию о поддержке uMod для определенных игр можно найти на сайте uMod

Установка uMod/Oxide

Загрузка по прямой ссылке

1. Загрузите версию uMod для вашего сервера.
2. Скопируйте файлы из архива в папку сервера с подтверждением замены

Плагины

Плагины - это отдельные фрагменты кода, которые изменяют поведение игрового сервера..

Для получения большего количества информации о плагинах посетите Plugins - Getting Started.

Посмотреть все плагины

Расширения

Расширения - это обычно большие проекты, которые добавляют функциональность в uMod или вносят существенные изменения в работу сервера.

Посмотреть все доступные расширения

Получение дополнительной информации

Поиск

Пожалуйста, пользуйтесь поиском прежде чем создавать новые темы.

1. Поиск в документации
2. Поиск ответов на форумах

Плагины и расширения

При возникновении проблем:

1. Посетите страницу ресурса и нажмите кнопку Help.
2. Создайте новую тему в обсуждениях ресурса.

Плагины

Плагины - это отдельные фрагменты кода, которые изменяют поведение игрового сервера.

Файлы плагина

Код плагинов написан на языке CSharp (C#), файл имеет расширение .cs.

Установка

Больше информации о установке плагина сможете найти на странице Plugins - Installation.

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

Большинство плагинов во время установки генерируют JSON конфигурационный файл, в котором можно настраивать работу плагина.

Больше информации о конфигурировании плагина можете найти на странице Plugins - Configuration.

Разрешения плагинов (permissions)

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

Больше информации про контроль доступа можете найти на странице Plugins - Permissions.

Команды плагинов

Многие плагины будут включать команды, которые могут использоваться игроками или администраторами сервера. Не каждая игра будет иметь оба типа команд, и по умолчанию команды могут быть доступны для консоли и в игре (если она доступна).

Консольные команды

Консольная команда это команда, которая запускается из:

• Внутриигровой консоли (если она есть в игре)
• Программное окно сервера (если поддерживается платформой)
• RCON консоль(если игра поддерживает RCON)

Chat - команды

Chat - команды вводятся игроками, которые подключены к игре. Chat - команды начинаются со знака /.

Например: /help

Установка плагинов

Установка uMod плагинов занимает всего пару щелчков мыши.

Требования сервера

Чтобы установить плагин на сервер, сервер должен поддерживать Oxide 2.0 или выше, иначе плагины не будут загружаться или делать что-либо.

Запустите сервер и проверьте установлен ли мод с помощью консольной команды oxide.version.

Загрузка исходного кода

Скачайте плагин этой странице;

Не переименовывайте плагин и не изменяйте его расширение

Удалённое управление

Если сервер расположен не локально, тогда подключитесь к серверу с помощью FTP client. Данные для подключения уточните у технической поддержки хостинга.

Папка плагинов

Найдите папку plugins, которая по умолчанию располагается по пути oxide/plugins

Загрузка исходного кода

Загрузите плагин в папку “plugins”, и он автоматически загрузится если плагин рабочий и мод Oxide установлен правильно

Продолжайте настройку путём настройки конфигурации плагина..

Обновление

Если плагин уже установлен и доступно обновление, просто перезапишите исходный файл (.cs) в папке plugins, и новая версия будет загружена автоматически.

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

Большинство плагинов во время загрузки генерируют JSON конфигурацию. С помощью этого файла (конфигурации) администраторы могут настроить работу плагина.

Папка конфигураций

Конфиги располагаются в папке config, которая расположена по пути oxide/config.

Имя файла

Файл конфигурации плагина имеет то же имя, что и сам плагин.

Например, плагин, с названием MyPlugin.cs (если он имеет конфигурацию) будет иметь конфиг с названием MyPlugin.json

Не переименовывайте файлы конфигов и не меняйте их расширение

Если плагин установлен, но не настраивается, файл конфигурации не будет создан.

Если плагин настраивается, но файл конфигурации недоступен, плагин может быть поврежден; в этом случае проверьте файлы журнала на наличие ошибок в папках oxide/logs.

Синтаксис файлов конфигурации JSON

Все файлы конфигурации плагина сохраняются в формате JSON (JavaScript Object Notation). Конфигурационные файлы не должны ошибок в синтаксисе. Используйте валидатор типа jsonlint.com для проверки конфигов.

Применение изменений

После внесения изменений в конфигурацию плагина, перезагрузите плагин с помощью консоли командой oxide.reload. Например:

oxide.reload MyPlugin

Разрешения плагинов (permissions)

Разрешения позволяют владельцам серверов предоставлять игрокам уникальные возможности и преимущества на своих серверах.

Администрировать разрешения просто: просто введите нужную команду, и все готово! Если на вашем сервере нет консоли, вы можете использовать любой совместимый инструмент RCON или удаленную консоль для отправки команд на сервер. Большинство игр с поддержкой Oxide / uMod также поддерживают команды разрешений в чате или будут доступны в ближайшее время.

Для этого руководства в качестве примера будет использовано разрешение epicstuff.use . Имейте в виду, что разрешения существуют только в том случае, если они предоставлены плагином или самим Oxide / uMod.

По умолчанию группы, которые создаются Oxide / uMod это: admin и default. Их можно изменить, отредактировав их в файле umod.config.json, или с помощью команд консоли если используете мод Oxide. Группа администраторов будет автоматически назначена игрокам, которые распознаются сервером как администратор. Группа «по умолчанию» будет автоматически назначена ВСЕМ игрокам, которые подключаются к серверу.

Игроки

Предоставить разрешение отдельному игроку

oxide.grant player Wulf epicstuff.use

Отозвать разрешение у отдельного игрока

oxide.revoke player Wulf epicstuff.use

Показать разрешения игрока

oxide.show player Wulf

Показывает, у какого игрока или группы есть разрешение

Иногда эта команда полезна при отслеживании того, у кого есть разрешение.

oxide.show perm epicstuff.use

Группы

Предоставить разрешение всей группе

oxide.grant group admin epicstuff.use

Отменить разрешение от группы

oxide.revoke group admin epicstuff.use

Добавление игрока в существующую группу

Добавление игрока в группу даст им все разрешения, назначенные этой группе.

oxide.usergroup add Wulf admin

Удаление игрока из существующей группы

Удаление игрока из группы приведет к удалению из него всех разрешений, назначенных этой группе..

oxide.usergroup remove Wulf admin

Добавление совершенно новой группы

oxide.group add vip

Удаление существующей группы

oxide.group remove vip

Установка названия или звания группы

Название группы обычно представляет собой краткое описание группы, иногда используемое для заголовков чата. Ранг - это число, которое сортирует группу по значимости..

oxide.group set vip “[VIP Member]” 1

Установка родительской группы другой группы

Группа унаследует все разрешения от своей родительской группы.

oxide.group parent admin default

Отображение членов группы и разрешений

oxide.show group admin

Отображение всех групп или разрешений

Чтобы показать все группы разрешений, просто используйте команду ниже.

oxide.show groups

Показать все зарегистрированные разрешения от плагинов и Oxide / uMod, используйте команду ниже.

oxide.show perms

Использование подстановочных знаков

Подстановочный знак - это то, что охватывает несколько вещей одновременно. Для разрешений это символ *. Вы можете использовать подстановочный знак (*) для предоставления нескольких разрешений одновременно. Это может быть сделано со всеми разрешениями или для каждого плагина на основе префикса.

oxide.grant group admin *, oxide.grant player Wulf umod.*

Выводы

Те же команды также доступны с префиксом “o.” (ex. “o.grant”).

Это основы разрешений для Oxide / uMod. Разрешения дают вам фантастический способ управления игроками, не беспокоясь о том, что они будут злоупотреблять полномочиями функций администратора игры (такими как полет, noclip, суперскорость и т.д.).

Файлы данных

Data - файлы это JSON файлы, которые плагины могут использовать для хранения произвольных данных.

Папка Data

Data - файлы располагаются в папке data, которую можно найти по пути oxide/data.

Названия файлов

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

Синтаксис файлов данных JSON

Все файлы данных плагинов хранятся в файле типа JSON (JavaScript Object Notation). Фалы данных не должны иметь синтаксических ошибок. При редактировании файла вручную используйте валидатор, например jsonlint.com

Ссылки

• Заказать сервер игры Rust
• Обсудить Rust в чате- Группа хостинга ВКонтакте

Основные и часто используемые команды сервера, для поиска интересующей команды или переменной вводите в консоль сервера команду find. Данные команды используются не только для работы с модифицированным сервером, но и для администрирования классических серверов.

Параметр	Тип значения	Пример	Описание
ownerid	64_bit_steam_id	ownerid “64_bit_steam_id” “опционально_никнейм” “опционально_причина”	Право администратора, позволяющее добавлять или удалять права администраторов или модераторов
moderatorid	64_bit_steam_id	moderatorid “64_bit_steam_id” “опционально_никнейм” “опционально_причина”	Право модератора, отличие от ownerid в том, что модератор не может добавлять или удалять права администраторов и модераторов
removeowner	“64_bit_steam_id”	removeowner64_bit_steam_id	Удаление прав администратора
removemoderator	64_bit_steam_id	removemoderator64_bit_steam_id	Удаление прав модератора
banid	64_bit_steam_id	banid 64_bit_steam_id опционально_причина	Выдаёт перманентный бан игроку
unban	64_bit_steam_id	unban 64_bit_steam_id	Снятие бана с игрока
banlist	не используется	banlist	Просмотр SteamID забаненных игроков
banlistex	не используется	banlistex	Просмотр SteamID и причин бана забаненных игроков
writecfg	не используется	writecfg	Сохранение параметров конфигов сервера (bans.cfg, serverauto.cfg, server.cfg, users.cfg)
readcfg	не используется	readcfg	Чтение параметров конфигов сервера (bans.cfg, serverauto.cfg, server.cfg, users.cfg)
find	команды, переменные	find ban, find decay	Консольная команда для поиска переменных и команд сервера
kick	никнейм, steamid	kick Frank "оскорбление игроков"	Отключение игрока от сервера, можно указывать причину
kickall	не используется	kickall	Отключение всех игроков от сервера
players	не используется	players	Вывод в консоль информации о подключённых игроках
say	текст сообщения	say Всем привет!	Вывод сообщения в игровой чат, используя консоль
mutechat	64_bit_steam_id	mutechat 64_bit_steam_id	Отключение игроку возможности писать в чат
unmutechat	64_bit_steam_id	unmutechat 64_bit_steam_id	Возвращение игроку возможности писать сообщения в чат
mutevoice	64_bit_steam_id	mutevoice 64_bit_steam_id	Отключение игроку возможности общаться через голосовой чат сервера
unmutevoice	64_bit_steam_id	unmutevoice 64_bit_steam_id	Возвращение игроку возможности общаться через голосовой чат сервера
serverinfo	не используется	serverinfo	Вывод в консоль информации о сервере
save	не используется	save	Сохранение игрового мира вручную. Полезно при выключении сервера через панель

Ссылки

• Заказать сервер игры Rust
• Обсудить Rust в чате- Группа хостинга ВКонтакте