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

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

Foundry — это воксельная игра о строительстве заводов, добыче ресурсов и автоматизации производственных цепочек в процедурно генерируемом мире.

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

Перед настройкой

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

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

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

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

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

Порядок действий:

1. Откройте сервер в панели управления
2. Перейдите во вкладку Startup
3. Проверьте основные переменные запуска
4. Укажите название сервера
5. При необходимости задайте пароль
6. Запустите сервер во вкладке Console
7. Дождитесь завершения первой загрузки
8. Остановите сервер перед ручным редактированием файлов

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

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

Изменение WORLD_NAME создаёт или загружает другой мир. Старый мир не удаляется, если его файлы сохранения остаются на сервере.

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

Расширенные параметры сервера находятся в файле:

App.cfg

Файл создаётся после первого запуска сервера.

Формат файла:

ключ=значение

Одна настройка указывается на одной строке.

Основные параметры App.cfg

Не изменяйте server_port и server_query_port вручную, если эти значения назначаются панелью управления. Порты в конфигурации должны совпадать с портами, выделенными серверу.

Пример App.cfg

server_name=TechNodes Foundry Server
server_password=
server_world_name=MyFoundry
server_max_players=16
server_is_public=true
server_port=3724
server_query_port=27015
map_seed=48293175
autosave_interval=300
pause_server_when_empty=true

После изменения App.cfg сохраните файл и запустите сервер повторно.

Генерация мира

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

Сид задаётся параметром:

map_seed=

или переменной запуска:

MAP_SEED

Один и тот же сид создаёт одинаковую начальную генерацию мира.

Изменение сида не меняет уже существующий мир. Чтобы новый сид вступил в силу, нужно создать новый мир, изменив имя мира:

server_world_name=

или переменную:

WORLD_NAME

Несколько миров

Параметр:

server_world_name=

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

Каждое уникальное имя мира создаёт отдельные данные сохранения.

Пример:

server_world_name=MainFactory

server_world_name=TestWorld

Для переключения мира:

1. Остановите сервер
2. Измените server_world_name или WORLD_NAME
3. Сохраните изменения
4. Запустите сервер

Предыдущие миры можно вернуть, указав их прежнее имя.

Пауза мира без игроков

Параметр:

pause_server_when_empty=

управляет поведением мира при отсутствии игроков.

Значение:

pause_server_when_empty=true

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

Значение:

pause_server_when_empty=false

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

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

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

Для подключения через список серверов:

1. Запустите Foundry
2. Откройте Multiplayer
3. Выберите Join Game
4. Найдите сервер по названию
5. Выберите сервер и нажмите Join
6. Введите пароль, если он установлен

Сервер отображается в браузере, если включено публичное отображение:

server_is_public=true

или:

PUBLIC_SERVER=true

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

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

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

Формат подключения:

IP:PORT

Пример:

123.123.123.123:3724

Если сервер защищён паролем, игра запросит его при подключении.

Автосохранение

Интервал автосохранения задаётся параметром:

autosave_interval=

Значение указывается в секундах.

Пример:

autosave_interval=300

300 секунд — это 5 минут.

Не устанавливайте слишком низкое значение для крупных миров. Частые автосохранения могут увеличивать нагрузку на сервер.

Расположение сохранений

Данные мира хранятся в каталоге сохранений сервера.

По умолчанию используется каталог:

serverfiles/

В нём находится состояние мира: изменённый ландшафт, постройки, производственные линии, машины, конвейеры, ресурсы и прогресс игроков.

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

server_persistent_data_override_folder

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

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

Порядок действий:

1. Остановите сервер в панели управления
2. Откройте файловый менеджер или подключитесь по SFTP
3. Перейдите в каталог сохранений
4. Скачайте папку мира или весь каталог serverfiles/
5. Сохраните копию на локальном устройстве или внешнем хранилище

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

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

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

1. Остановите сервер
2. Откройте файловый менеджер или подключитесь по SFTP
3. Перейдите в каталог сохранений
4. Загрузите резервную копию мира
5. Убедитесь, что имя папки совпадает с server_world_name
6. Запустите сервер

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

Рекомендации по производительности

Производительность сервера Foundry зависит от размера мира, сложности завода и количества игроков.

На нагрузку влияют:

количество машин
количество конвейеров
размер производственных цепочек
количество активных зон завода
количество игроков онлайн
частота автосохранения
постоянная симуляция мира без игроков

Для стабильной работы сервера:

не задавайте слишком частое автосохранение
уменьшайте MAX_PLAYERS при высокой нагрузке
держите производственные зоны компактнее
используйте pause_server_when_empty=true, если мир не должен работать без игроков
создавайте резервные копии перед крупными изменениями завода

Частые проблемы

Сервер не отображается в браузере

Проверьте:

server_is_public=true

или:

PUBLIC_SERVER=true

Также убедитесь, что query-порт сервера назначен в панели управления и совпадает с конфигурацией.

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

Проверьте значение:

server_password=

или переменную:

SRV_PW

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

После смены сида мир не изменился

Сид применяется только при создании нового мира.

Чтобы создать мир с новым сидом, измените:

server_world_name=

или:

WORLD_NAME

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

Проверьте имя мира:

server_world_name=

Оно должно совпадать с папкой сохранения существующего мира.

Изменения в App.cfg не применились

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

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