Администрирование

Данная статья описывает администрирование выделенного сервера Hurtworld: назначение администратора, консольные команды, управление игроками, сохранение мира, поддержку Oxide/uMod, установку плагинов и устранение распространённых проблем.

Как работает администрирование

В текущей конфигурации сервера Hurtworld администратор добавляется через переменную запуска:

ADMINS

В startup-команде это значение передаётся серверу через параметр:

addadmin {{ADMINS}}

В переменную ADMINS нужно указать SteamID64 администратора или владельца сервера.

Пример SteamID64:

76561198012345678

Внимание: используйте именно SteamID64, а не ник игрока, SteamID3 или ссылку на профиль.

Назначение администратора

1. Остановите сервер.
2. Откройте вкладку «Startup».
3. Найдите переменную ADMINS.
4. Укажите SteamID64 администратора.
5. Сохраните изменения.
6. Запустите сервер.

После запуска сервер применит параметр addadmin и выдаст указанному SteamID административный доступ.

Как узнать SteamID64

SteamID64 — это 17-значный идентификатор Steam-аккаунта.

Обычно он начинается с:

7656119

Если у игрока используется пользовательская ссылка Steam, преобразуйте ссылку профиля в SteamID64 через любой удобный SteamID-конвертер.

Где вводить команды

Команды можно вводить через консоль сервера во вкладке «Console».

В игре консоль обычно открывается клавишей:

F1

Для выполнения административных команд в игре у игрока должен быть выдан административный доступ.

Команды управления игроками

Примеры команд управления игроками

status
kick 76561198012345678
ban 76561198012345678
unban 76561198012345678

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

Команды мира и сервера

Примеры серверных команд

save
say "Сервер будет перезапущен через 5 минут"
quit
settime 12

Перед перезапуском или остановкой сервера рекомендуется выполнить:

save

После сохранения сервер можно остановить или перезапустить через панель управления.

Команды выдачи предметов

Некоторые версии Hurtworld и модифицированные серверы поддерживают команды выдачи предметов.

Внимание: команды выдачи предметов могут влиять на баланс сервера. Используйте их осторожно, особенно на публичных PvP-серверах.

autoexec.cfg

Для постоянных настроек сервер может использовать файл:

autoexec.cfg

Если файла нет, его можно создать в корневом каталоге сервера.

Файл использует синтаксис консольных команд: одна команда на строку.

Перед редактированием остановите сервер.

Пример autoexec.cfg

servername "TechNodes Hurtworld"
maxplayers 40
lootscale 1.5
resourcescale 2
craftscale 1
pvp true
protectalivetimeout 30
autosaveinterval 300

Внимание: параметры, которые уже передаются через startup-команду, лучше менять во вкладке «Startup», а не вручную в autoexec.cfg. В текущей startup-команде уже передаются host, queryport, maxplayers, servername, creativemode и addadmin.

Oxide/uMod

Текущий egg поддерживает установку Oxide/uMod для Hurtworld.

Установка управляется переменной запуска:

INSTALL_OXIDE

Значения:

0 — не устанавливать Oxide/uMod
1 — установить Oxide/uMod

Если вы хотите использовать плагины, установите:

INSTALL_OXIDE=1

Внимание: установка Oxide/uMod выполняется установочным скриптом. Если сервер уже установлен, простого рестарта может быть недостаточно. Может потребоваться переустановка сервера или ручная установка uMod.

Автоматическая установка плагинов

Для автоматической установки плагинов используется переменная:

INSTALL_PLUGINS

Плагины указываются через запятую.

Пример:

No Build Zones,Loot Chests,HW Time Control

Установщик пытается скачать соответствующие .cs файлы и поместить их в каталог:

oxide/plugins/

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

Ручная установка плагинов

1. Остановите сервер.
2. Убедитесь, что Oxide/uMod установлен.
3. Скачайте файл плагина .cs.
4. Загрузите файл в каталог oxide/plugins/.
5. Запустите сервер.
6. Проверьте консоль на наличие ошибок компиляции.

Каталоги Oxide/uMod

Команды управления плагинами

Примеры команд Oxide/uMod

oxide.plugins
oxide.reload Kits
oxide.unload Kits
oxide.load Kits

После редактирования конфигурации плагина обычно достаточно выполнить:

oxide.reload PluginName

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

Большинство плагинов создают конфигурационные файлы после первого запуска.

Обычно они находятся в каталоге:

oxide/config/

Порядок настройки:

1. Установите плагин.
2. Запустите сервер, чтобы плагин создал конфиг.
3. Остановите сервер или выгрузите плагин.
4. Отредактируйте JSON-файл в oxide/config/.
5. Запустите сервер или выполните oxide.reload PluginName.

Данные плагинов

Данные плагинов хранятся в каталоге:

oxide/data/

Если вы переносите сервер, восстанавливаете резервную копию или делаете вайп, учитывайте этот каталог отдельно. В нём могут находиться дома, киты, кланы, статистика, привязки игроков и другие данные, зависящие от установленных плагинов.

Резервное копирование перед изменениями

Перед установкой новых плагинов, обновлением Oxide/uMod или изменением конфигурации создайте резервную копию.

Минимально рекомендуется сохранить:

saves/
autoexec.cfg
oxide/plugins/
oxide/config/
oxide/data/

Сервер падает после установки плагина

Если сервер начал падать после установки плагина:

1. Остановите сервер.
2. Откройте каталог oxide/plugins/.
3. Удалите или временно переместите последний установленный плагин.
4. Запустите сервер.
5. Проверьте консоль и логи Oxide.

Если сервер запустился после удаления плагина, проблема связана с этим плагином, его зависимостями или совместимостью.

Плагины не загружаются

Проверьте:

• INSTALL_OXIDE был включён при установке сервера;
• файл плагина находится прямо в oxide/plugins/;
• файл имеет расширение .cs;
• плагин совместим с Hurtworld;
• в консоли нет ошибок компиляции;
• название плагина не было указано неправильно в INSTALL_PLUGINS.

Команды администратора не работают

Проверьте:

• в ADMINS указан правильный SteamID64;
• сервер был перезапущен после изменения ADMINS;
• администратор подключается с тем же Steam-аккаунтом;
• команда поддерживается текущей версией Hurtworld;
• в консоли нет ошибок запуска;
• если используется Oxide/uMod, нет конфликтующих плагинов прав или администрирования.

Игроки не могут подключиться

Проверьте:

• сервер полностью запущен;
• используется правильный IP и игровой порт;
• порт SERVER_PORT выделен серверу;
• QUERY_PORT выделен серверу;
• версия игры у игрока совпадает с версией сервера;
• сервер не заполнен по MAX_PLAYERS;
• игрок не заблокирован.

Проблемы с производительностью

Если сервер начинает лагать:

• уменьшите MAX_PLAYERS;
• проверьте количество установленных плагинов;
• отключите плагины с частыми таймерами или тяжёлыми проверками;
• проверьте размер сохранений;
• проверьте консоль на повторяющиеся ошибки;
• проверьте нагрузку тарифа.

Сервер не запускается

Если сервер не запускается после изменения настроек:

• проверьте последнюю ошибку во вкладке «Console»;
• временно уберите недавно добавленные плагины из oxide/plugins/;
• проверьте autoexec.cfg;
• проверьте значения во вкладке «Startup»;
• убедитесь, что файл Hurtworld.x86_64 существует;
• проверьте, что серверные файлы были успешно установлены через SteamCMD.

Быстрые команды администратора

status
save
say "Сервер будет перезапущен через 5 минут"
kick 76561198012345678
ban 76561198012345678
unban 76561198012345678
quit

Быстрые команды Oxide/uMod

oxide.plugins
oxide.reload PluginName
oxide.unload PluginName
oxide.load PluginName

Рекомендации

• назначайте администратора через ADMINS и SteamID64;
• после изменения ADMINS перезапускайте сервер;
• перед остановкой сервера выполняйте save;
• перед установкой плагинов включите INSTALL_OXIDE;
• не устанавливайте много плагинов сразу — добавляйте их по одному и проверяйте запуск;
• перед редактированием autoexec.cfg останавливайте сервер;
• перед вайпом, обновлением или сменой плагинов создавайте резервную копию;
• каталоги oxide/config/ и oxide/data/ важны не меньше, чем сами плагины.

Файлы, каталоги и параметры, которые рекомендуется проверять при администрировании:

ADMINS
INSTALL_OXIDE
INSTALL_PLUGINS
autoexec.cfg
saves/
oxide/plugins/
oxide/config/
oxide/data/
oxide/logs/