Vintage Story: установка и настройка сервера

Как установить и настроить сервер Vintage Story на Linux: serverconfig.json, порт 42420, моды, команды администратора и бэкапы.

Кратко: Для запуска сервера Vintage Story на Linux нужен .NET 7+ и архив серверного ПО с официального сайта. Всё ключевое - порт, пароль, слоты, конфиг мира - задаётся в serverconfig.json. После запуска сервер доступен по порту 42420 UDP.

Vintage Story: установка и настройка сервера

Vintage Story - это survival-игра с глубокой механикой выживания, геологией и крафтом, которая прекрасно играется в кооперативе. По состоянию на 2026 год проект активно развивается: выходят крупные обновления, а сообщество создаёт тысячи модов на ModDB. Собственный выделенный сервер даёт полный контроль над настройками мира, правилами игры и списком участников - без зависимости от сторонних платформ. В этой статье разберём установку серверного ПО на Linux (Ubuntu/Debian), настройку serverconfig.json, управление модами и администрирование.

Pterohost - игровой хостинг с NVMe-дисками, DDoS-защитой и поддержкой 24/7, оптимальный для кооп-серверов Vintage Story. Промокод 4START даёт -20% на первый заказ. Заказать сервер Vintage Story

Требования и подготовка сервера

Перед установкой убедитесь, что ваш Linux-сервер удовлетворяет минимальным требованиям:

Сначала установите .NET Runtime (если его ещё нет):

# Ubuntu/Debian - добавляем репозиторий Microsoft
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt-get update
sudo apt-get install -y dotnet-runtime-8.0

Проверьте установку:

dotnet --version
# Ожидаемый вывод: 8.0.x

Создайте отдельного пользователя и рабочую директорию - запускать сервер от root не рекомендуется:

sudo adduser --system --no-create-home vsserver
sudo mkdir -p /srv/vsserver/{bin,data,mods}
sudo chown -R vsserver:nogroup /srv/vsserver

Скачивание и распаковка серверного ПО

Серверный дистрибутив Vintage Story распространяется через официальный сайт. Найдите актуальную ссылку на странице загрузок https://www.vintagestory.at/downloads.php - ищите файл вида vs_server_linux-x64_X.X.X.tar.gz.

cd /srv/vsserver/bin

# Замените X.X.X на актуальную версию (например 1.20.3)
wget https://cdn.vintagestory.at/gamefiles/stable/vs_server_linux-x64_X.X.X.tar.gz

# Распаковываем
tar -xzf vs_server_linux-x64_X.X.X.tar.gz

# Убираем архив
rm vs_server_linux-x64_X.X.X.tar.gz

После распаковки структура /srv/vsserver/bin будет выглядеть так:

/srv/vsserver/bin/
  VintagestoryServer.dll
  VintagestoryServer.deps.json
  Lib/
  assets/
  ...

Настройка serverconfig.json

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

nano /srv/vsserver/data/serverconfig.json

Пример рабочего конфига с подробными пояснениями:

{
  "ServerName": "Мой сервер Vintage Story",
  "ServerDescription": "Кооп-выживание для друзей",
  "ServerUrl": "",
  "ServerPassword": "mysecretpassword",
  "Port": 42420,
  "MaxClients": 10,
  "Gamemode": 0,
  "WorldConfig": {
    "Seed": "",
    "WorldName": "myworld",
    "PlayStyle": "surviveandbuild",
    "PlayStyleLang": "surviveandbuild-bands",
    "WorldType": "standard",
    "WorldConfiguration": {
      "worldClimate": "realistic",
      "polarEquatorDistance": "15000",
      "landcover": "1",
      "worldWidth": "1024000",
      "worldHeight": "256",
      "worldLength": "1024000"
    }
  },
  "StartupCommands": [],
  "WhitelistMode": false,
  "MaxChunkRadius": 12,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "MapSizeY": 256,
  "AntiAbuse": true,
  "CorpseDropsInventory": true,
  "AllowPvP": false,
  "AllowFireSpread": true,
  "AllowFallingBlocks": true,
  "OnlyWhitelisted": false,
  "AdvertiseServer": true,
  "LogFile": "server-main.log"
}

Ключевые параметры:

Параметры мира (WorldConfig)

Секция WorldConfiguration управляет генерацией мира:

• worldClimate - realistic (реалистичный климат) или patchy (случайные биомы)
• polarEquatorDistance - расстояние от полюса до экватора в блоках
• worldWidth / worldLength - размер мира (стандарт 1024000 блоков)
• landcover - плотность суши, значение от 0.0 до 1.0

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

Запустите сервер вручную для проверки:

cd /srv/vsserver/bin
dotnet VintagestoryServer.dll --dataPath /srv/vsserver/data

Если всё настроено правильно, в консоли появятся строки вида:

[Server Event] Server started
[Server Event] Now listening on port 42420

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

/stop

Открытие порта в файрволле

Обязательно откройте порт 42420 UDP:

# UFW (Ubuntu)
sudo ufw allow 42420/udp
sudo ufw reload

# iptables
sudo iptables -A INPUT -p udp --dport 42420 -j ACCEPT
sudo iptables-save > /etc/iptables/rules.v4

Запуск через systemd

Для автоматического старта при перезагрузке создайте systemd-юнит:

sudo nano /etc/systemd/system/vsserver.service

[Unit]
Description=Vintage Story Server
After=network.target

[Service]
Type=simple
User=vsserver
WorkingDirectory=/srv/vsserver/bin
ExecStart=/usr/bin/dotnet VintagestoryServer.dll --dataPath /srv/vsserver/data
Restart=on-failure
RestartSec=10
StandardOutput=journal
StandardError=journal
SyslogIdentifier=vsserver

[Install]
WantedBy=multi-user.target

Активируйте и запустите:

sudo systemctl daemon-reload
sudo systemctl enable vsserver
sudo systemctl start vsserver

# Проверка статуса
sudo systemctl status vsserver

# Просмотр логов в реальном времени
sudo journalctl -u vsserver -f

Установка модов через ModDB

Официальный репозиторий модов Vintage Story - сайт mods.vintagestory.at. Там вы найдёте тысячи модов: от геймплейных изменений до косметических дополнений.

Процесс установки мода на сервер:

1. Найдите мод на mods.vintagestory.at и скачайте .zip-файл
2. Скопируйте .zip в папку Mods на сервере:

# Пример: копируем скачанный архив мода
cp ~/downloads/xskills_v2.3.1.zip /srv/vsserver/data/Mods/

# Убедитесь, что права доступа правильные
sudo chown vsserver:nogroup /srv/vsserver/data/Mods/xskills_v2.3.1.zip

3. Перезапустите сервер:

sudo systemctl restart vsserver

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

Список популярных серверных модов (2026)

Команды администратора

Команды вводятся либо в консоли сервера (без /), либо в игровом чате от имени оператора (с /).

Управление игроками

# Назначить оператора
/op НикИгрока

# Снять права оператора
/deop НикИгрока

# Кик игрока
/kick НикИгрока Причина

# Бан игрока
/ban НикИгрока Причина

# Разбан
/unban НикИгрока

# Список онлайн-игроков
/players

Белый список (whitelist)

# Включить белый список (ещё нужно WhitelistMode: true в конфиге)
/whitelist on

# Добавить игрока в список
/whitelist add НикИгрока

# Убрать из списка
/whitelist remove НикИгрока

# Показать список
/whitelist list

Управление миром и временем

# Установить время суток (0.0 - полночь, 0.5 - полдень)
/time set 0.5

# Ускорить время (1.0 - реальное, 3.0 - в 3 раза быстрее)
/time speed 2.0

# Изменить параметр мира на лету
/worldconfig allowpvp true
/worldconfig allowfallentities true
/worldconfig snowAccum false

# Изменить режим игры для конкретного игрока
/gamemode creative НикИгрока

# Телепортировать игрока
/tp НикИгрока x y z

Сервисные команды

# Остановить сервер
/stop

# Сохранить мир вручную
/save

# Послать сообщение всем
/say Текст сообщения

# Перезапустить сервер (если установлен watchdog)
/restart

Бэкапы мирового сохранения

Мир хранится в файле с расширением .vcdbs по пути:

/srv/vsserver/data/Saves/myworld.vcdbs

Ручной бэкап

# Создаём резервную копию с датой
cp /srv/vsserver/data/Saves/myworld.vcdbs \
   /srv/vsserver/backups/myworld_$(date +%Y%m%d_%H%M).vcdbs

Автоматический бэкап через cron

# Создаём папку для бэкапов
mkdir -p /srv/vsserver/backups

# Открываем crontab
crontab -e

Добавьте строку для ежедневного бэкапа в 03:00:

0 3 * * * cp /srv/vsserver/data/Saves/myworld.vcdbs /srv/vsserver/backups/myworld_$(date +\%Y\%m\%d).vcdbs

Ротация старых бэкапов

Чтобы не переполнить диск, настройте удаление бэкапов старше 14 дней:

30 3 * * * find /srv/vsserver/backups -name "*.vcdbs" -mtime +14 -delete

Восстановление из бэкапа

# Останавливаем сервер
sudo systemctl stop vsserver

# Заменяем текущее сохранение
cp /srv/vsserver/backups/myworld_20260601.vcdbs \
   /srv/vsserver/data/Saves/myworld.vcdbs

# Запускаем сервер
sudo systemctl start vsserver

Кооп с друзьями: как подключиться

После того как сервер запущен и порт открыт, игроки могут подключиться через меню “Multiplayer” в клиенте Vintage Story:

1. Откройте Vintage Story на клиентской машине
2. Перейдите в “Multiplayer” - “Connect to server”
3. Введите IP-адрес вашего сервера и порт: 123.45.67.89:42420
4. Если задан пароль - введите его при подключении

Для удобства друзей можно добавить сервер в список “Favorite Servers” - тогда он будет отображаться на вкладке “Your servers”.

Проверка доступности порта

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

# На сервере - смотрим, слушает ли процесс нужный порт
ss -ulnp | grep 42420

# С другой машины - проверяем UDP (нужен netcat)
nc -zuv ВАШ_IP 42420

Обновление сервера

При выходе новой версии Vintage Story обновление сводится к замене файлов:

# Останавливаем сервер
sudo systemctl stop vsserver

# Скачиваем новую версию
cd /tmp
wget https://cdn.vintagestory.at/gamefiles/stable/vs_server_linux-x64_NEW_VERSION.tar.gz

# Делаем бэкап старых бинарников
cp -r /srv/vsserver/bin /srv/vsserver/bin_backup_$(date +%Y%m%d)

# Распаковываем новую версию поверх старой
tar -xzf vs_server_linux-x64_NEW_VERSION.tar.gz -C /srv/vsserver/bin

# Исправляем права
sudo chown -R vsserver:nogroup /srv/vsserver/bin

# Запускаем сервер
sudo systemctl start vsserver

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

Мониторинг и диагностика сервера

Просмотр логов

Сервер Vintage Story ведёт лог в файл и через journald (если запущен через systemd). Для диагностики проблем смотрите оба источника:

# Логи systemd в реальном времени
sudo journalctl -u vsserver -f

# Последние 100 строк лога
sudo journalctl -u vsserver -n 100

# Файл лога сервера
tail -f /srv/vsserver/data/Logs/server-main.log

# Поиск ошибок в логе
grep -i "error\|exception\|crash" /srv/vsserver/data/Logs/server-main.log

Использование памяти и CPU

# Посмотреть потребление ресурсов процессом сервера
ps aux | grep VintagestoryServer

# Использование памяти в динамике
watch -n 5 'ps -o pid,rss,%cpu,comm -p $(pgrep -f VintagestoryServer)'

# Через systemd
systemctl status vsserver

Типичные проблемы и решения

Если сервер зависает или падает с OutOfMemoryException - уменьшите MaxChunkRadius в serverconfig.json с 12 до 8 или ограничьте максимальное количество игроков.

Связанные материалы

Если вас интересуют другие survival-игры с выделенными серверами, посмотрите наши гайды: Настройка сервера Valheim - схожая механика выживания с Viking-тематикой, Сервер Terraria: установка и настройка - 2D-выживание с глубоким крафтом, а также Настройка сервера Project Zomboid - один из самых требовательных к настройке survival-серверов.

Заключение

Установка сервера Vintage Story на Linux занимает около 20 минут: скачать .NET, распаковать серверный дистрибутив, заполнить serverconfig.json и запустить через systemd. Основная точка настройки - файл serverconfig.json, где задаются имя сервера, пароль, лимит игроков и параметры генерации мира. Моды устанавливаются простым копированием .zip-архивов в папку Mods. Для стабильной работы важно настроить автоматические бэкапы и следить за обновлениями игры - разработчики выпускают их регулярно.

Pterohost - хостинг игровых серверов с быстрыми NVMe-дисками, защитой от DDoS-атак и круглосуточной поддержкой - идеальный вариант, если не хочется возиться с настройкой железа самому. Промокод 4START даёт -20% на первый заказ. Заказать сервер Vintage Story