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

Это руководство описывает настройку выделенного сервера Portal Knights: первый запуск, переменные запуска, файл конфигурации, подключение игроков и управление сохранениями мира.

Описание сервера

Portal Knights — кооперативная action-RPG с элементами песочницы. Игроки исследуют острова, сражаются с боссами, строят сооружения, открывают порталы и развивают персонажей в общем мире.

Выделенный сервер позволяет держать мир онлайн постоянно, даже когда владелец сервера не находится в игре.

Первый запуск

После выдачи сервера откройте панель управления и перейдите во вкладку Startup.

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

SERVER_NAME
ADMIN_PASS
USER_PASS
GUEST_PASS
GAMEMODE
UNIVERSE_SIZE

После настройки перейдите во вкладку Console и запустите сервер.

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

Переменные запуска

Основные параметры сервера задаются через переменные запуска.

После изменения переменных запуска перезапустите сервер.

Название сервера

Название сервера задаётся переменной:

SERVER_NAME

Оно отображается в браузере серверов Portal Knights.

Рекомендуется использовать короткое и узнаваемое название. Максимальная длина имени сервера — 32 символа.

Пароли доступа

Portal Knights использует несколько уровней доступа.

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

Не используйте стандартное значение:

admin_password_please_change

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

Игровой режим

Режим игры задаётся переменной:

GAMEMODE

Доступные значения:

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

Размер вселенной

Размер мира задаётся переменной:

UNIVERSE_SIZE

Доступные значения:

Размер вселенной влияет на количество островов и общий масштаб мира.

Для большинства серверов подходит значение:

Normal

Файл конфигурации

Основной файл конфигурации сервера находится по пути:

dedicated_server/server_config.json

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

Перед редактированием server_config.json остановите сервер. Изменения, внесённые во время работы процесса, могут быть перезаписаны.

Основные параметры server_config.json

Пример server_config.json

{
  "basicServerData": {
    "name": "My Portal Knights Server",
    "ipv4": "0.0.0.0",
    "port": 27015,
    "saveFolderPath": "./savedata"
  },
  "admins": {
    "credentials": {
      "password": "my_admin_password"
    }
  },
  "users": {
    "credentials": {
      "password": ""
    }
  },
  "guests": {
    "credentials": {
      "password": ""
    }
  },
  "gameplayMode": "Adventure",
  "universeSize": "Normal",
  "hideConsoleWindow": true
}

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

Порт сервера

Порт указывается в параметре:

"port": 27015

Используйте только порт, назначенный серверу во вкладке Network панели управления.

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

Папка сохранений

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

"saveFolderPath": "./savedata"

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

dedicated_server/savedata/

Не изменяйте путь к сохранениям без необходимости. Если путь указан неверно, сервер может создать новый пустой мир или не найти существующее сохранение.

Настройки мира

Мир Portal Knights состоит из островов, соединённых порталами.

На структуру мира влияют два основных параметра:

gameplayMode
universeSize

gameplayMode определяет режим игры.

universeSize определяет размер вселенной.

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

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

IP-адрес и порт сервера отображаются во вкладке Network панели управления.

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

Запустите Portal Knights через Steam.

Откройте:

Multiplayer → Online Game → Browse Servers

Найдите сервер по названию, указанному в:

SERVER_NAME

Выберите сервер и подключитесь. Если установлен пароль, введите соответствующий пароль доступа.

Прямое подключение

Для прямого подключения откройте:

Multiplayer → Online Game → Direct Connect

Введите адрес в формате:

IP:PORT

Пример:

123.123.123.123:27015

Используйте IP и порт из вкладки Network панели управления.

Управление сохранениями

Сохранения мира находятся в каталоге:

dedicated_server/savedata/

Этот путь соответствует параметру:

"saveFolderPath": "./savedata"

Перед заменой, удалением или загрузкой сохранений остановите сервер.

Ручная резервная копия

Для создания резервной копии:

1. Остановите сервер.
2. Откройте файловый менеджер или подключитесь по SFTP.
3. Перейдите в каталог:

dedicated_server/savedata/

4. Скачайте папку сохранений на локальный компьютер.

Храните резервную копию отдельно от сервера.

Восстановление сохранения

Для восстановления сохранения:

1. Остановите сервер.
2. Откройте каталог:

dedicated_server/savedata/

3. Загрузите резервную копию сохранения.
4. Убедитесь, что параметр saveFolderPath указывает на правильный каталог.
5. Запустите сервер.

Перед заменой файлов сохранения создайте копию текущего состояния мира.

Сервер не появляется в списке

Проверьте:

сервер полностью запущен
SERVER_NAME задан корректно
порт совпадает с назначенным портом
сервер не находится в состоянии ошибки

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

Для проверки подключения используйте прямое подключение через IP и порт.

Не удаётся подключиться

Проверьте:

IP-адрес сервера
порт из вкладки Network
значение basicServerData.port
пароль доступа
состояние сервера в Console

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

Сервер создаёт новый мир вместо старого

Проверьте параметр:

"saveFolderPath": "./savedata"

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

Верните прежний путь или переместите сохранение в каталог, указанный в saveFolderPath.

Ошибка конфигурации

server_config.json должен быть корректным JSON-файлом.

Проверьте:

кавычки
запятые
фигурные скобки
корректные значения Adventure/Creative
корректные значения Small/Normal/Large

Если конфигурация повреждена, остановите сервер, создайте резервную копию файла, удалите повреждённый server_config.json и запустите сервер для генерации нового файла.

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

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

Останавливайте сервер перед редактированием server_config.json.

Используйте только назначенный порт из панели управления.

Не меняйте saveFolderPath, если не переносите сохранения вручную.

Создавайте резервные копии каталога savedata перед обновлениями и изменениями мира.

Для приватного сервера используйте пароль доступа.

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