Руководство по настройке сервера Vintage Story

В этом руководстве описано, как настроить и сконфигурировать ваш выделенный сервер Vintage Story, размещённый на Legion Hosting, включая первый запуск, переменные GPanel, управление версиями, конфигурацию сервера, настройки мира, подключение игроков и управление сохранениями. Сведения об установке модов см. в статье Установка модов Vintage Story. Сведения о настройке администратора и командах см. в статье Команды администратора Vintage Story.

Прежде чем начать: Убедитесь, что ваш сервер создан в GPanel. Если вам нужна помощь в поиске IP-адреса и порта вашего сервера, см. статью Как узнать IP-адрес и порт вашего сервера.

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

При первом запуске вашего сервера Vintage Story из GPanel сервер автоматически загрузит файлы игры из официального API Vintage Story и сгенерирует мир по умолчанию. Этот первоначальный запуск может занять несколько минут, пока файлы загружаются и распаковываются.

Войдите в GPanel и выберите ваш сервер Vintage Story.
Перед запуском просмотрите вкладку Startup, чтобы подтвердить предпочитаемую ветку версий (stable, unstable или pre-release).
Нажмите Start на вкладке Console. Следите за выводом консоли на предмет сообщений о ходе процесса, пока сервер загружает и устанавливает файлы игры.
Как только вы увидите сообщение о том, что сервер ожидает подключений, сервер готов. Файл serverconfig.json по умолчанию будет сгенерирован автоматически.

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

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

Основные настройки сервера управляются через вкладку Startup в GPanel. Просмотрите и скорректируйте их перед запуском сервера.

Переменная	По умолчанию	Описание
`SERVER_PORT`	(назначается)	Игровой порт, который игроки используют для подключения. Назначается автоматически GPanel — проверьте вкладку Network для вашего назначенного порта.
`MAX_CLIENTS`	`16`	Максимальное число одновременных игроков. Можно установить до 256. Должно соответствовать ресурсам вашего тарифного плана хостинга.
`FILES_BRANCH`	`stable`	Какую ветку выпуска использовать. Варианты: `stable`, `unstable` или `pre`. Подробнее см. в разделе «Управление версиями» ниже.
`RELEASE_VERSION`	`latest`	Конкретная версия для установки. Установите `latest`, чтобы всегда использовать новейший выпуск на выбранной ветке, или введите конкретный номер версии (например, `1.19.8`), чтобы закрепить эту версию.
`OPTIONS`	(пусто)	Дополнительные аргументы командной строки, передаваемые процессу сервера при запуске. Оставьте пустым, если вам не нужны специальные флаги запуска.
`SQLITE_TMPDIR`	(авто)	Временный каталог, используемый SQLite для операций с базой данных. Обычно не требует изменения.

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

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

Vintage Story предлагает три ветки выпуска. Выбор ветки задаётся через переменную запуска FILES_BRANCH в GPanel.

Ветка	Значение	Описание
Stable	`stable`	Рекомендуемая ветка для большинства серверов. Эти выпуски тщательно протестированы и наиболее надёжны для долгосрочных миров.
Unstable	`unstable`	Бета-выпуски с новыми функциями и изменениями, которые ещё тестируются. Могут содержать ошибки. Используйте, если хотите получить ранний доступ к новому контенту и готовы мириться с некоторой нестабильностью.
Pre-release	`pre`	Ранние сборки разработки. Наименее протестированы и могут иметь значительные проблемы. Рекомендуются только для целей тестирования — не для рабочих серверов.

Закрепление конкретной версии

По умолчанию RELEASE_VERSION установлен на latest, что означает, что сервер будет загружать и устанавливать новейшую доступную версию на выбранной ветке при каждом запуске сервера (если доступна более новая версия). Чтобы предотвратить автоматические обновления и зафиксировать ваш сервер на конкретной версии:

Перейдите на вкладку Startup в GPanel.
Измените RELEASE_VERSION с latest на точный номер нужной версии (например, 1.19.8).
Перезапустите сервер. Он будет использовать только закреплённую версию независимо от более новых выпусков.

Совместимость модов: Если вы используете моды, рекомендуется закрепить конкретную версию. Обновления игры могут нарушить совместимость модов, а обновление в середине прохождения может вызвать проблемы. Проверьте, что ваши моды поддерживают целевую версию, перед обновлением. Подробнее см. в статье Установка модов Vintage Story.

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

serverconfig.json

Основной файл конфигурации сервера — serverconfig.json, расположенный в корневом каталоге сервера. Этот файл генерируется автоматически при первом запуске. Остановите сервер перед его редактированием, затем перезапустите, чтобы изменения вступили в силу.

Остановите сервер на вкладке Console в GPanel.
Откройте вкладку Files и нажмите на serverconfig.json, чтобы отредактировать его.
Измените необходимые настройки (см. таблицу ниже).
Сохраните файл и запустите сервер.

Ключевые настройки

Настройка	Пример значения	Описание
`ServerName`	`"My Legion VS Server"`	Имя, отображаемое во внутриигровом браузере серверов. Сделайте его описательным, чтобы игроки могли найти ваш сервер.
`WelcomeMessage`	`"Welcome to the server!"`	Сообщение, показываемое игрокам при входе. Поддерживает базовое форматирование.
`MaxClients`	`16`	Максимальное число одновременных игроков. Должно соответствовать переменной запуска `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	Пароль, необходимый для входа на сервер. Оставьте пустую строку (`""`) для публичного сервера.
`AllowPvP`	`true`	Установите `true`, чтобы включить бой между игроками, или `false` для сервера только с PvE.
`SpawnRadius`	`50`	Радиус (в блоках) вокруг точки спавна мира, где могут появляться новые игроки. Большее значение сильнее распределяет игроков при входе.
`MapSizeX`	`1024000`	Ширина мира в блоках. Значение по умолчанию создаёт очень большой мир. Уменьшение ограничивает, как далеко игроки могут путешествовать с запада на восток.
`MapSizeZ`	`1024000`	Глубина мира в блоках. Значение по умолчанию создаёт очень большой мир. Уменьшение ограничивает, как далеко игроки могут путешествовать с севера на юг.
`WorldSeed`	`"myseed123"`	Зерно (seed), используемое для генерации мира. Одно и то же зерно производит один и тот же мир. Оставьте пустую строку для случайного зерна.

Минимальный пример ключевых настроек в serverconfig.json:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

Файл должен быть корректным JSON. Убедитесь, что все строки заключены в двойные кавычки, логические значения записаны в нижнем регистре (true/false), и после последнего элемента в объекте или массиве нет завершающих запятых. Если сервер не запускается после редактирования, проверьте наличие синтаксических ошибок JSON.

Конфигурация мира

Vintage Story генерирует свой мир на основе настроек в serverconfig.json. Генерация мира происходит только при первом запуске с данным миром — изменение настроек генерации после создания мира не изменит задним числом существующий ландшафт.

Настройки генерации мира

WorldSeed: Определяет расположение ландшафта, размещение биомов и распределение ресурсов. Установите конкретное зерно, чтобы поделиться одинаковой компоновкой мира с другими, или оставьте пустым для случайно сгенерированного мира.
MapSizeX / MapSizeZ: Управляют максимальной игровой областью. Меньшие значения создают более ограниченный мир и могут снизить использование ресурсов. Игроки, достигшие края карты, не смогут двигаться дальше в этом направлении.
WorldConfig: Объект WorldConfig внутри serverconfig.json позволяет точно настроить параметры генерации мира, такие как масштаб форм рельефа, климатические закономерности и геологические особенности. Это расширенные настройки — значения по умолчанию хорошо работают для большинства серверов.

Настройки генерации мира блокируются после создания. Настройки, такие как WorldSeed, MapSizeX и MapSizeZ, вступают в силу только при первой генерации мира. Чтобы применить новые настройки генерации, необходимо создать новый мир (см. «Управление сохранениями» ниже).

Выбор зерна

Зерно может быть любой текстовой строкой или числом. Игроки сообщества Vintage Story делятся зёрнами для интересных компоновок мира. Если вам нужен конкретный тип ландшафта или место спавна, поищите рекомендуемые зёрна на форумах Vintage Story или сайтах сообщества.

Как подключиться

Игроки подключаются к вашему серверу Vintage Story через внутриигровое многопользовательское меню.

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

Запустите Vintage Story и нажмите Multiplayer в главном меню.
Нажмите Direct Connect.
Введите IP-адрес и игровой порт вашего сервера в формате:
```
your.server.ip:port
```
Проверьте вкладку Network в GPanel для вашего назначенного IP и порта.
Нажмите Connect. Если у сервера есть пароль, введите его при запросе.

Браузер серверов

Запустите Vintage Story и нажмите Multiplayer в главном меню.
Браузер серверов загрузит список публичных серверов. Используйте строку поиска, чтобы найти ваш сервер по имени (значение ServerName из serverconfig.json).
Нажмите на ваш сервер в списке и нажмите Join.

Сервер не появляется в браузере? Браузеру серверов может потребоваться несколько минут, чтобы проиндексировать недавно запущенный сервер. Используйте Direct Connect для немедленного доступа. Также убедитесь, что вы не установили пароль — серверы, защищённые паролем, могут не появляться в публичном браузере в зависимости от настроек сервера.

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

Данные мира Vintage Story хранятся на вашем сервере и сохраняются автоматически во время игры.

Расположение данных мира

Файлы сохранения мира хранятся в каталоге data/ на вашем сервере. Точный путь зависит от имени вашего мира. Вы можете получить доступ к этим файлам через вкладку Files в GPanel или через SFTP.

Резервное копирование вашего мира

Остановите сервер, чтобы обеспечить чистую резервную копию (файлы не записываются в середине сохранения).
Подключитесь к вашему серверу через SFTP. Инструкции по подключению см. в статье Как загружать файлы через SFTP.
Скачайте весь каталог data/ на ваш локальный компьютер.
Храните резервную копию в безопасном месте. Рассмотрите возможность хранения нескольких датированных резервных копий на случай, если вам потребуется откатиться к определённой точке.

Настоятельно рекомендуется регулярное резервное копирование. Повреждение мира, случайный гриферинг или неудачные обновления модов — всё это может привести к потере данных. Создавайте резервную копию вашего мира перед любыми значительными изменениями, такими как обновление версии игры, добавление или удаление модов или изменение настроек мира.

Сброс мира

Чтобы начать совершенно новый мир:

Остановите сервер на вкладке Console в GPanel.
Создайте резервную копию существующих данных мира, если хотите их сохранить (см. выше).
Перейдите в каталог data/ в файловом менеджере GPanel и удалите файлы сохранения мира.
При желании обновите WorldSeed в serverconfig.json, чтобы сгенерировать другую компоновку мира.
Запустите сервер. Новый мир будет сгенерирован с нуля с использованием ваших текущих настроек конфигурации.

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

Нужна помощь?

Если вы столкнулись с проблемой, не описанной в этом руководстве, создайте тикет в службу поддержки и укажите IP-адрес вашего сервера, описание проблемы и любой соответствующий вывод консоли из GPanel.

Руководство по настройке сервера Vintage Story - База знаний

Поддержка

Категории

Руководство по настройке сервера Vintage Story