Pterohost docs

Vintage Story: установка модов ModDB на сервер

Как установить моды ModDB на сервер Vintage Story: папка Mods, серверные и клиентские моды, версии API, популярные моды, обновление.

Кратко: Моды для Vintage Story скачиваются с ModDB (mods.vintagestory.at) в формате .zip и копируются в папку Mods на сервере. Серверные моды не требуют ничего от клиента, клиент-серверные - нужны обеим сторонам. Главное - сверять версию API мода с версией сервера.

Vintage Story: установка модов ModDB на сервер

Vintage Story - это уникальная инди-игра с глубокой системой выживания и геологией, которая с каждым годом наращивает базу пользователей и библиотеку модов. В 2026 году репозиторий ModDB (mods.vintagestory.at) насчитывает тысячи модификаций - от косметических дополнений до глобальных геймплейных изменений. Правильная установка модов на сервер требует понимания нескольких ключевых вещей: типов модов, версий API, структуры папок и механизма синхронизации с клиентами. В этой статье разберём весь процесс пошагово - от скачивания мода до проверки его работы на сервере.

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

Структура папок сервера Vintage Story

Прежде чем устанавливать моды, важно разобраться, где хранятся данные сервера. Vintage Story разделяет установочную директорию (бинарники игры) и директорию данных (миры, конфиги, моды).

Директория данных по умолчанию:

  • Linux: ~/.config/VintagestoryData/
  • Windows: %APPDATA%\VintagestoryData\

Если вы запускаете сервер с флагом --dataPath, директория будет другой. Проверьте ваш скрипт запуска:

# Пример кастомного пути данных
./VintagestoryServer --dataPath /opt/vintagestory/data

В директории данных нас интересуют следующие папки:

VintagestoryData/
├── Mods/           <- сюда кладём моды (.zip файлы)
├── ModConfig/      <- конфигурационные файлы модов
├── Saves/          <- сохранения миров
├── Logs/           <- логи сервера
└── serverconfig.json

Папка Mods/ создаётся автоматически при первом запуске сервера. Если её нет - просто создайте вручную:

mkdir -p ~/.config/VintagestoryData/Mods

Как скачать моды с ModDB

Официальный репозиторий модов для Vintage Story - mods.vintagestory.at. Это не тот ModDB, который используется для других игр. Именно здесь разработчики публикуют свои работы, а сообщество оставляет отзывы и рейтинги.

Поиск нужного мода

На сайте mods.vintagestory.at можно фильтровать моды по:

  • Версии игры (поле “Game version”) - очень важно для совместимости
  • Тегу “Server-side” - если нужны только серверные моды
  • Категории: Gameplay, Technology, Magic, QoL и другие
  • Рейтингу и дате обновления

Что проверить перед скачиванием

На странице каждого мода обязательно смотрите:

ПараметрГде смотретьПочему важно
Game VersionВкладка “Files” или описаниеДолжна совпадать с версией сервера
SideОписание или тегиserver-side, client-side или universal
DependenciesРаздел “Dependencies”Может требовать другие моды
Last UpdatedЗаголовок страницыДавно не обновлявшиеся моды рискованны

Скачивание через wget/curl

Если у вас нет GUI (типичная ситуация для VPS или выделенного сервера), можно скачать мод прямо с консоли. На странице мода нажмите правой кнопкой на кнопку “Download” и скопируйте ссылку:

# Скачать мод прямо в папку Mods
wget -P ~/.config/VintagestoryData/Mods/ "https://mods.vintagestory.at/download?fileid=XXXXX"

# Или через curl
curl -L -o ~/.config/VintagestoryData/Mods/modname-1.2.3.zip \
  "https://mods.vintagestory.at/download?fileid=XXXXX"

Замените XXXXX на реальный ID файла из URL на странице мода.

Серверные и клиентские моды - в чём разница

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

Server-side (только серверные)

Устанавливаются только на сервер. Клиент не знает об их существовании и не требует их для подключения. Типичные примеры:

  • Административные инструменты (логирование, анти-гриф)
  • Генераторы мира и биомов на стороне сервера
  • Балансировочные патчи существ и лута
  • Моды на экономику и торговлю

Пример из modinfo.json внутри архива такого мода:

{
  "modid": "serverlogger",
  "name": "Server Logger",
  "version": "1.3.0",
  "side": "Server",
  "requiredOnClient": false
}

Client-side (только клиентские)

На сервер не устанавливаются. Это визуальные улучшения, UI-моды, шейдеры. Ставятся только игроками локально. Если случайно положить такой мод в папку Mods на сервере - ничего страшного, он просто будет проигнорирован (или выдаст предупреждение в логе).

Universal / Both sides

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

  • Новые предметы, блоки, рецепты
  • Расы и классы персонажей
  • Новые биомы с кастомными ресурсами
  • Технические и магические системы

Версии API и совместимость

Каждый мод в своём modinfo.json указывает, с какой версией игры он совместим. Несовпадение версий - главная причина проблем с модами.

Как проверить версию своего сервера

# Запустить сервер с флагом --version
./VintagestoryServer --version

# Или найти в логе после запуска
grep "Game Version" ~/.config/VintagestoryData/Logs/server-main.log

Таблица совместимости API

Vintage Story использует семантическое версионирование. Начиная с версии 1.17, API был существенно переработан. Общее правило:

Версия модаСовместим с серверомПримечание
1.20.x1.20.xТочное совпадение - идеально
1.19.x1.20.xЧасто работает, но без гарантий
1.18.x1.20.xМогут быть проблемы с новым API
1.17.x и старше1.20.xВысокий риск несовместимости

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

Файл modinfo.json

Каждый мод - это .zip архив с определённой структурой. Можно разархивировать и проверить вручную:

# Посмотреть содержимое мода без распаковки
unzip -p modname.zip modinfo.json

Пример валидного modinfo.json для мода типа “universal”:

{
  "modid": "xskills",
  "name": "XSkills",
  "version": "0.8.5",
  "description": "Adds skills and experience system",
  "authors": ["Xandu"],
  "side": "Universal",
  "requiredOnClient": true,
  "requiredOnServer": true,
  "dependencies": {
    "game": "1.19.0",
    "xlib": "0.7.0"
  }
}

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

Пошаговая установка мода на сервер

Шаг 1. Остановите сервер

Никогда не копируйте моды во время работы сервера - это может вызвать ошибки при следующем запуске:

# Если используется systemd
systemctl stop vintagestory

# Или через консоль сервера
/stop

Шаг 2. Скачайте мод с ModDB

cd ~/.config/VintagestoryData/Mods/
wget "https://mods.vintagestory.at/download?fileid=XXXXX" -O modname-1.0.0.zip

Рекомендуется сохранять оригинальное имя файла с версией - это упрощает управление при обновлениях.

Шаг 3. Проверьте структуру архива

unzip -l modname-1.0.0.zip | head -20

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

Шаг 4. Для universal-модов - передайте клиентам

Если мод типа “Universal”, все игроки должны установить его у себя. Есть два способа:

Способ 1 - Ручной. Дайте игрокам ссылку на ModDB, они скачают и установят сами в свою клиентскую папку Mods.

Способ 2 - Авторелей через сервер. Vintage Story 1.19+ поддерживает механизм автоматического уведомления клиентов о нужных модах. При подключении сервер отправляет список обязательных модов, и лаунчер предлагает их скачать автоматически. Для этого мод должен быть опубликован на официальном ModDB.

Шаг 5. Запустите сервер и проверьте лог

systemctl start vintagestory

# Следите за логом в реальном времени
tail -f ~/.config/VintagestoryData/Logs/server-main.log

Ищите строки вида:

[Server Info] Mod loaded: modname 1.0.0
[Server Error] Mod modname 1.0.0: requires game version >= 1.20.0, but server is running 1.19.8

Популярные моды для Vintage Story в 2026 году

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

Геймплейные (Universal - нужны клиентам)

XSkills - система прокачки навыков. Один из самых популярных модов. Добавляет опыт за добычу, крафт, бой. Активно поддерживается, совместим с 1.19+.

Wildcraft: Flora - расширяет флору мира, добавляет сотни новых растений, кустарников, деревьев. Требует клиентскую часть из-за новых текстур.

Primitive Survival - добавляет ловушки, удочки, дополнительные рецепты выживания. Популярен на RP-серверах.

Medieval Expansion - новые строительные блоки в средневековом стиле, мебель, декор. Обязателен для RP-серверов с атмосферой.

Серверные (только на сервер)

Server Essentials - базовые административные команды: варп-точки, хоум, кит. Не требует ничего от клиента.

Better Ruins - улучшает генерацию заброшенных структур на стороне сервера. Ставится только на сервер, влияет на генерацию мира.

Anti Grief Tools - логирование действий игроков, откат блоков. Работает полностью на стороне сервера.

Таблица популярных модов

МодТипОписаниеВерсия API
XSkillsUniversalСистема навыков и опыта1.19+
Wildcraft: FloraUniversalРасширенная флора1.19+
Primitive SurvivalUniversalВыживание и ловушки1.18+
Medieval ExpansionUniversalСтроительство и декор1.19+
Server EssentialsServerАдминистративные команды1.17+
Better RuinsServerУлучшенная генерация руин1.19+

Обновление модов и управление версиями

Обновление одного мода

# 1. Остановить сервер
systemctl stop vintagestory

# 2. Удалить старую версию (важно - не оставлять дубли!)
rm ~/.config/VintagestoryData/Mods/modname-1.0.0.zip

# 3. Скачать новую версию
wget -P ~/.config/VintagestoryData/Mods/ \
  "https://mods.vintagestory.at/download?fileid=XXXXX" \
  -O modname-1.1.0.zip

# 4. Запустить сервер
systemctl start vintagestory

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

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

Для серверов с большим количеством модов удобно вести список и обновлять через скрипт:

#!/bin/bash
# update-mods.sh - список модов для обновления
# Остановить сервер перед запуском!

MODS_DIR="$HOME/.config/VintagestoryData/Mods"

declare -A MODS=(
  ["xskills-0.8.5.zip"]="https://mods.vintagestory.at/download?fileid=12345"
  ["primitivesurvival-3.3.7.zip"]="https://mods.vintagestory.at/download?fileid=23456"
)

for filename in "${!MODS[@]}"; do
  url="${MODS[$filename]}"
  echo "Downloading $filename..."
  wget -q -O "$MODS_DIR/$filename" "$url"
done

echo "Done. Start the server manually."

Откат мода к предыдущей версии

Если новая версия мода вызвала проблемы - откатитесь назад. На странице мода в ModDB есть вкладка “Files”, где доступны все версии:

# Удалить новую версию
rm ~/.config/VintagestoryData/Mods/modname-1.1.0.zip

# Скачать предыдущую версию (ссылку взять с вкладки Files на ModDB)
wget -P ~/.config/VintagestoryData/Mods/ \
  "https://mods.vintagestory.at/download?fileid=YYYYY" \
  -O modname-1.0.0.zip

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

Большинство модов создают свои конфиги в папке ModConfig/ при первом запуске:

VintagestoryData/
└── ModConfig/
    ├── xskills.json
    ├── primitivesurvival.json
    └── serveressentials.json

Редактировать конфиги нужно при остановленном сервере - часть модов не перечитывает их на лету. Типичная структура конфига:

{
  "xskillsConfig": {
    "enableXP": true,
    "xpMultiplier": 1.5,
    "maxLevel": 100,
    "allowedWorlds": []
  }
}

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

Диагностика проблем с модами

Мод не загрузился

Проверьте лог:

grep -i "mod\|error\|warning" ~/.config/VintagestoryData/Logs/server-main.log | head -50

Частые причины:

  • Несовпадение версии API (в логе будет “requires game version X”)
  • Отсутствие зависимого мода (“requires mod X”)
  • Повреждённый архив (проверьте через unzip -t modname.zip)
  • Дубль мода в папке (две версии одного modid)

Клиент не может подключиться из-за мода

Если игрок видит ошибку “Missing mods” или “Mod version mismatch”:

  1. Убедитесь, что игрок установил все Universal-моды из вашего списка
  2. Версии модов на клиенте и сервере должны совпадать точно
  3. Дайте игроку точные ссылки на нужные версии с вкладки Files на ModDB

Проверка загруженных модов

В консоли сервера (подключившись как администратор):

/modslist

Или в логе при запуске сервера найдите секцию:

[Server Info] Loaded mods:
  - game@1.20.4 (Game)
  - creative@1.20.4 (Creative Mode)
  - xskills@0.8.5 (XSkills)
  - primitivesurvival@3.3.7 (Primitive Survival)

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

Если вы только разворачиваете игровой сервер, полезно ознакомиться с нашими гайдами по похожим играм выживания: Настройка сервера Terraria с описанием плагинов tModLoader, Сервер Project Zomboid с настройкой модов Steam Workshop, а также Сервер 7 Days to Die - там тоже есть нюансы с серверными и клиентскими модами.

Заключение

Установка модов на сервер Vintage Story - это несложный процесс, если понимать ключевые принципы. Всегда сверяйте версию API мода с версией сервера, различайте серверные и универсальные моды, не оставляйте дублей в папке Mods. Для universal-модов обеспечьте синхронизацию с клиентами - дайте им точные ссылки на нужные версии. При любых проблемах первый шаг - серверный лог, он скажет всё о причинах сбоя. С правильно настроенными модами Vintage Story превращается в гораздо более глубокую и интересную игру, чем в ванильном виде.

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