Посібник з налаштування сервера 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"`	Сід, що використовується для генерації світу. Той самий сід створює той самий світ. Залиште порожнім рядком для випадкового сіду.

Мінімальний приклад ключових налаштувань у 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.

Сервер не з'являється в браузері? Браузеру серверів може знадобитися кілька хвилин, щоб проіндексувати нещодавно запущений сервер. Використовуйте пряме підключення для негайного доступу. Також переконайтеся, що ви не встановили пароль — захищені паролем сервери можуть не з'являтися в публічному браузері залежно від налаштувань сервера.

Керування збереженнями

Дані світу Vintage Story зберігаються на вашому сервері та зберігаються автоматично під час гри.

Розташування даних світу

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

Резервне копіювання вашого світу

Зупиніть сервер, щоб забезпечити чисту резервну копію (без файлів, що записуються посеред збереження).
Підключіться до свого сервера через SFTP. Дивіться Як завантажувати файли через SFTP для інструкцій з підключення.
Завантажте весь каталог data/ на свій локальний комп'ютер.
Зберігайте резервну копію в безпечному місці. Розгляньте можливість зберігання кількох датованих резервних копій на випадок, якщо вам потрібно буде повернутися до конкретного моменту.

Регулярні резервні копії наполегливо рекомендуються. Пошкодження світу, випадковий грифінг або невдалі оновлення модів — усе це може призвести до втрати даних. Створюйте резервну копію світу перед внесенням будь-яких значних змін, таких як оновлення версії гри, додавання чи видалення модів або зміна налаштувань світу.

Скидання світу

Щоб почати абсолютно новий світ:

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

Видалення файлів світу є остаточним. Після видалення світ неможливо відновити, якщо у вас немає резервної копії. Завжди завантажуйте резервну копію перед виконанням скидання світу.

Пов'язані статті

Потрібна допомога?

Якщо у вас виникла проблема, яка не висвітлена в цьому посібнику, відкрийте тікет підтримки та вкажіть IP-адресу вашого сервера, опис проблеми та будь-який відповідний вивід консолі з GPanel.

Посібник з налаштування сервера Vintage Story - База знань

Підтримка

Категорії

Посібник з налаштування сервера Vintage Story