Настройка сервера

Это руководство описывает настройку выделенного сервера Enshrouded: основной конфиг, пароли ролей, лимит игроков, порты, сохранения мира, сложность и подключение игроков.

Enshrouded на выделенном сервере настраивается через файл:

enshrouded_server.json

Файл находится в корневой директории сервера и создаётся после первого запуска, если его ещё нет.

Рекомендуемые ресурсы

Enshrouded заметно требовательнее многих survival-серверов. Для небольшого сервера на несколько игроков лучше ориентироваться не на минимальный запуск, а на стабильную работу мира.

• 4–6 игроков: желательно от 16 GB RAM;
• до 16 игроков: желательно 16 GB RAM и более сильный процессор;
• диск: SSD, минимум около 30 GB под серверные файлы;
• сеть: примерно 2 Mbit/s upload на каждого активного игрока.

Если сервер упирается в память или процессор, сначала снижайте slotCount, а уже потом ищите проблемы в конфиге. Для Enshrouded высокий расход памяти сам по себе не является ошибкой.

Основной файл конфигурации

Базовый файл:

enshrouded_server.json

Типовой набор ключей:

{
  "name": "Enshrouded Server",
  "saveDirectory": "./savegame",
  "logDirectory": "./logs",
  "ip": "0.0.0.0",
  "gamePort": 15636,
  "queryPort": 15637,
  "slotCount": 16,
  "voiceChatMode": "Proximity",
  "enableVoiceChat": false,
  "enableTextChat": false,
  "gameSettingsPreset": "Default",
  "userGroups": []
}

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

Главные параметры

• name — название сервера в списке серверов;
• saveDirectory — папка сохранений мира;
• logDirectory — папка логов;
• ip — адрес привязки сервера, обычно 0.0.0.0;
• gamePort — игровой порт, если он используется вашей сборкой;
• queryPort — Steam Query порт для поиска сервера и избранного Steam;
• slotCount — лимит игроков, допустимое значение от 1 до 16;
• voiceChatMode — режим голосового чата: Proximity или Global;
• enableVoiceChat — включение голосового чата;
• enableTextChat — включение текстового чата;
• gameSettingsPreset — пресет сложности и правил мира.

Порты

Для Enshrouded важно не путать игровой порт и Query порт.

• gamePort — порт игрового подключения;
• queryPort — порт Steam Query, который используется для отображения сервера в списках и избранном Steam.

Если игрок добавляет сервер в избранное Steam, обычно используется связка:

IP:QUERY_PORT

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

Пароли и роли игроков

В Enshrouded доступ к серверу управляется через userGroups. У каждой группы может быть свой пароль и свой набор прав.

Старое поле:

"password": ""

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

Пример userGroups

{
  "userGroups": [
    {
      "name": "Admin",
      "password": "AdminPassword",
      "canKickBan": true,
      "canAccessInventories": true,
      "canEditBase": true,
      "canExtendBase": true,
      "reservedSlots": 1
    },
    {
      "name": "Friend",
      "password": "FriendPassword",
      "canKickBan": false,
      "canAccessInventories": true,
      "canEditBase": true,
      "canExtendBase": true,
      "reservedSlots": 2
    },
    {
      "name": "Guest",
      "password": "GuestPassword",
      "canKickBan": false,
      "canAccessInventories": false,
      "canEditBase": false,
      "canExtendBase": false,
      "reservedSlots": 0
    }
  ]
}

Пароль, который вводит игрок при подключении, определяет его группу и права. Например, игрок с паролем от группы Admin получает права администратора, а игрок с паролем от Guest получает ограниченный доступ.

Права групп

• canKickBan — разрешает кикать и банить игроков;
• canAccessInventories — разрешает доступ к контейнерам, сундукам и инвентарям;
• canEditBase — разрешает изменять постройки на базе;
• canExtendBase — разрешает расширять базу и работать с Flame Altar;
• reservedSlots — резервирует слоты для этой группы.

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

Рекомендуемая схема ролей

• Admin — только для владельца и доверенных администраторов;
• Friend — для постоянных игроков, которым можно доверять строительство и доступ к контейнерам;
• Guest — для новых игроков без доступа к базе и контейнерам.

Для закрытого сервера обычно достаточно двух групп: Admin и Friend. Группу Guest имеет смысл оставлять, если сервер рассчитан на игроков с ограниченными правами.

Лимит игроков

Параметр:

"slotCount": 16

задаёт максимальное количество игроков на сервере. Допустимый диапазон — от 1 до 16.

Если сервер работает нестабильно, снижайте slotCount. Enshrouded сильно зависит от активности игроков в мире: строительство, исследование, бой и загрузка территорий заметно увеличивают нагрузку.

Настройки сложности

Основной параметр сложности:

"gameSettingsPreset": "Default"

Доступные пресеты:

• Default — стандартная сложность;
• Relaxed — облегчённый режим с большим упором на строительство и исследование;
• Hard — более агрессивные враги и сложнее бои;
• Survival — дополнительный упор на survival-механику;
• Custom — ручная настройка отдельных параметров.

Индивидуальные параметры сложности работают только при использовании:

"gameSettingsPreset": "Custom"

Если оставить Default, Relaxed, Hard или Survival, ручные значения из секции gameSettings могут не применяться так, как ожидается.

Сохранения мира

Путь сохранений задаётся параметром:

"saveDirectory": "./savegame"

По умолчанию мир хранится в папке:

savegame/

Эту папку нужно сохранять перед обновлениями, переносом сервера, изменением критичных параметров или сбросом мира.

Если изменить saveDirectory, сервер начнёт искать мир в новом месте. Если там нет сохранений, он может создать новый мир. Поэтому без необходимости этот параметр лучше не менять.

Логи сервера

Путь логов задаётся параметром:

"logDirectory": "./logs"

Логи полезны при проблемах с запуском, ошибках JSON, недоступности сервера в списке или конфликтах настроек.

Если сервер не стартует после изменения конфига, в первую очередь проверяйте последние строки логов и консоль запуска.

Подключение к серверу

Игрокам нужны:

• IP-адрес сервера;
• игровой порт или адрес подключения из панели;
• пароль нужной группы из userGroups.

Пароль выбирает не просто доступ к серверу, а уровень прав игрока. Например, разные пароли могут давать права Admin, Friend или Guest.

Если сервер добавляется в избранное Steam, используйте Query порт:

IP:QUERY_PORT

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

Если сервер не отображается

• проверьте, что используется queryPort, а не игровой порт, при добавлении в избранное Steam;
• проверьте, что ip оставлен как 0.0.0.0, если нет особой сетевой причины менять его;
• проверьте, что Query порт открыт и назначен серверу в панели;
• убедитесь, что сервер полностью запустился, а не завис на ошибке конфига.

Если пароль не подходит

• проверьте пароль внутри нужной группы в userGroups;
• не используйте старое поле "password" как основной пароль сервера;
• убедитесь, что пароль не содержит лишних пробелов;
• проверьте, что JSON сохранён корректно;
• перезапустите сервер после изменения пароля.

Если настройки не применились

• файл enshrouded_server.json содержит ошибку JSON;
• редактируется не тот файл или не та копия конфига;
• значение указано вне допустимого диапазона;
• для ручных настроек сложности не включён "gameSettingsPreset": "Custom";
• сервер был запущен до сохранения изменений;
• панель или startup-шаблон перезаписывает часть параметров при запуске.

Если после изменения конфиг ведёт себя странно, проверьте синтаксис JSON. Ошибка в одной запятой или скобке может привести к тому, что сервер не запустится или пересоздаст конфиг.

Минимальный рабочий пример

{
  "name": "My Enshrouded Server",
  "saveDirectory": "./savegame",
  "logDirectory": "./logs",
  "ip": "0.0.0.0",
  "gamePort": 15636,
  "queryPort": 15637,
  "slotCount": 16,
  "voiceChatMode": "Proximity",
  "enableVoiceChat": false,
  "enableTextChat": false,
  "gameSettingsPreset": "Default",
  "userGroups": [
    {
      "name": "Admin",
      "password": "ChangeThisAdminPassword",
      "canKickBan": true,
      "canAccessInventories": true,
      "canEditBase": true,
      "canExtendBase": true,
      "reservedSlots": 1
    },
    {
      "name": "Friend",
      "password": "ChangeThisFriendPassword",
      "canKickBan": false,
      "canAccessInventories": true,
      "canEditBase": true,
      "canExtendBase": true,
      "reservedSlots": 0
    }
  ]
}

Что лучше не трогать без причины

• saveDirectory — смена пути может привести к запуску другого мира;
• ip — обычно должен оставаться 0.0.0.0;
• queryPort — должен совпадать с портом, назначенным серверу;
• gamePort — должен совпадать с игровым портом сервера, если используется вашей сборкой;
• старое поле password — для актуальной схемы доступа используйте userGroups.