Администрирование
Администрирование сервера Portal Knights
Это руководство описывает управление выделенным сервером Portal Knights: уровни доступа, пароли, управление игроками, сохранения мира, перезапуск сервера и базовую диагностику.
Portal Knights имеет ограниченный набор серверных команд по сравнению с survival-песочницами. Основное администрирование выполняется через конфигурационный файл, пароли доступа, панель управления и внутриигровые возможности хоста.
Уровни доступа
Portal Knights использует несколько уровней доступа к серверу:
admin
user
guest
Пароли для этих уровней задаются в файле конфигурации:
dedicated_server/server_config.json
Основные секции:
"admins": {
"credentials": {
"password": "admin_password"
}
},
"users": {
"credentials": {
"password": "user_password"
}
},
"guests": {
"credentials": {
"password": "guest_password"
}
}
Пароль администратора предоставляет максимальный уровень доступа. Не передавайте его обычным игрокам.
Пароль администратора
Пароль администратора задаётся переменной запуска:
ADMIN_PASS
В конфигурационном файле он соответствует параметру:
"admins": {
"credentials": {
"password": "your_admin_password"
}
}
После изменения пароля перезапустите сервер.
Не используйте стандартный пароль:
admin_password_please_change
Пароли пользователей и гостей
Для ограничения доступа можно использовать отдельные пароли:
USER_PASS
GUEST_PASS
В server_config.json они соответствуют:
"users": {
"credentials": {
"password": "user_password"
}
},
"guests": {
"credentials": {
"password": "guest_password"
}
}
Если сервер должен быть открытым для подключения без дополнительного пароля, оставьте соответствующие значения пустыми.
Управление доступом игроков
Portal Knights не использует полноценную систему банов и RCON-команд, поэтому основной способ контроля доступа — пароли.
Чтобы ограничить вход на сервер:
- Остановите сервер.
- Откройте вкладку Startup или файл
server_config.json. - Измените пароль нужного уровня доступа.
- Сохраните изменения.
- Запустите сервер.
После смены пароля игроки со старым паролем не смогут подключиться.
Управление игроками в игре
В Portal Knights управление игроками выполняется через внутриигровое меню доступного уровня хоста или администратора.
Доступные действия зависят от версии игры и уровня доступа, но обычно управление включает:
просмотр игроков в сессии
исключение игрока из текущей сессии
контроль доступа через пароль
Если нужно удалить нежелательного игрока, используйте внутриигровое меню игроков и выполните действие Kick, если оно доступно.
Для постоянного ограничения доступа измените пароль сервера.
Ограничение количества игроков
Portal Knights рассчитан на небольшую кооперативную группу. Если требуется контролировать размер сессии, используйте пароль и выдавайте его только нужным игрокам.
Если в вашей сборке сервера используется параметр лимита игроков, не устанавливайте значение выше поддерживаемого игрой лимита.
Управление режимом игры
Режим сервера задаётся переменной запуска:
GAMEMODE
В конфигурационном файле:
"gameplayMode": "Adventure"
Доступные значения:
| Значение | Назначение |
|---|---|
Adventure |
Основной режим с прогрессией, порталами, островами и боссами |
Creative |
Творческий режим для строительства и свободного исследования |
После изменения режима перезапустите сервер.
Режим лучше выбирать до активной игры на мире. Изменение режима на уже используемом сохранении может привести к нежелательному поведению мира или прогрессии.
Управление размером вселенной
Размер мира задаётся переменной:
UNIVERSE_SIZE
В конфигурационном файле:
"universeSize": "Normal"
Доступные значения:
| Значение | Назначение |
|---|---|
Small |
Маленькая вселенная |
Normal |
Стандартный размер |
Large |
Большая вселенная |
Размер вселенной влияет на количество островов. Изменять его рекомендуется до создания нового мира.
Переключение мира
Путь к сохранениям задаётся параметром:
"saveFolderPath": "./savedata"
По умолчанию сохранения находятся здесь:
dedicated_server/savedata/
Чтобы использовать другой набор сохранений:
- Остановите сервер.
- Создайте новую папку для сохранений или загрузите существующую.
- Укажите путь в
saveFolderPath. - Запустите сервер.
Пример:
"saveFolderPath": "./savedata"
Не меняйте путь к сохранениям без необходимости. Если указать пустую или новую папку, сервер может создать новый мир.
Сброс мира
Чтобы начать новый мир:
- Остановите сервер.
- Создайте резервную копию каталога:
dedicated_server/savedata/
- Удалите или переименуйте текущую папку сохранений.
- Запустите сервер.
После запуска сервер создаст новый мир.
Удаление сохранений без резервной копии безвозвратно удаляет прогресс, постройки и состояние островов.
Резервное копирование мира
Перед обновлениями, изменением режима или заменой мира создайте резервную копию.
Путь сохранений:
dedicated_server/savedata/
Порядок действий:
- Остановите сервер.
- Откройте файловый менеджер или подключитесь по SFTP.
- Скачайте каталог
savedata. - Сохраните копию отдельно от сервера.
Рекомендуется добавлять дату в название резервной копии.
Пример:
savedata_backup_2026-02-26
Восстановление резервной копии
Для восстановления мира:
- Остановите сервер.
- Откройте каталог:
dedicated_server/
- Замените текущий каталог
savedataна резервную копию. - Проверьте параметр:
"saveFolderPath": "./savedata"
- Запустите сервер.
Перед заменой текущего мира сохраните его отдельной резервной копией.
Перезапуск сервера
Перезапуск требуется после изменения:
SERVER_NAME
ADMIN_PASS
USER_PASS
GUEST_PASS
GAMEMODE
UNIVERSE_SIZE
server_config.json
saveFolderPath
Для корректного перезапуска используйте обычную остановку через панель управления:
Stop → Start
Не используйте принудительное завершение процесса, если сервер отвечает на штатную остановку.
Проверка консоли
Вкладка Console используется для контроля состояния сервера.
Через консоль можно проверить:
запуск сервера
ошибки конфигурации
создание мира
подключения игроков
состояние процесса
Если сервер не запускается, сначала проверьте последние строки консоли.
Игроки не могут подключиться
Проверьте:
сервер запущен
порт совпадает с basicServerData.port
игрок использует правильный IP и порт
пароль введён правильно
сервер не завершился с ошибкой
Порт указывается в конфигурации:
"port": 27015
Он должен совпадать с портом, назначенным серверу в панели управления.
Сервер не отображается в списке
Проверьте:
сервер полностью запущен
SERVER_NAME задан корректно
порт указан правильно
сервер не находится в состоянии ошибки
После запуска серверу может потребоваться несколько минут для отображения в браузере.
Для проверки используйте прямое подключение:
IP:PORT
Сервер создаёт новый мир
Если после запуска появился новый мир, проверьте параметр:
"saveFolderPath": "./savedata"
Частые причины:
изменён путь к папке сохранений
папка savedata была удалена
резервная копия загружена не в тот каталог
сервер запущен с другой конфигурацией
Верните прежний путь или загрузите нужное сохранение в каталог, указанный в saveFolderPath.
Потеря доступа администратора
Если администраторский доступ недоступен:
- Остановите сервер.
- Проверьте переменную
ADMIN_PASS. - Проверьте секцию
admins.credentials.passwordвserver_config.json. - Убедитесь, что пароль не пустой.
- Запустите сервер.
- Подключитесь с актуальным паролем администратора.
Если пароль был скомпрометирован, смените его и перезапустите сервер.
Рекомендации
Перед первым запуском смените пароль администратора.
Не передавайте ADMIN_PASS обычным игрокам.
Используйте отдельные пароли для пользователей и гостей.
Останавливайте сервер перед изменением server_config.json.
Создавайте резервные копии dedicated_server/savedata/ перед изменениями мира.
Не изменяйте saveFolderPath, если не переносите сохранения вручную.
После изменения переменных запуска всегда перезапускайте сервер.
Для ограничения доступа используйте смену пароля, а не удаление файлов мира.