Ръководство за настройка на Vintage Story сървър

Това ръководство покрива как да настроите и конфигурирате вашия специализиран Vintage Story сървър, хостван с Legion Hosting, включително първоначално стартиране, GPanel променливи, управление на версии, конфигурация на сървъра, настройки на света, свързване на играчи и управление на запазвания. За инсталиране на модове вижте Инсталиране на модове за Vintage Story. За админ настройка и команди вижте Vintage Story админ команди.

Преди да започнете: Уверете се, че сървърът ви е създаден в GPanel. Ако имате нужда от помощ да намерите IP адреса и порта на сървъра си, вижте Как да намерите IP адреса и порта на сървъра си.

Първо стартиране

Когато стартирате вашия Vintage Story сървър за първи път от GPanel, сървърът автоматично ще изтегли файловете на играта от официалния Vintage Story API и ще генерира стандартен свят. Това първоначално стартиране може да отнеме няколко минути, докато файловете се изтеглят и разархивират.

Влезте в 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`	Ранни build-ове за разработка. Те са най-малко тествани и може да имат значителни проблеми. Препоръчват се само за тестови цели -- не за продукционни сървъри.

Фиксиране на конкретна версия

По подразбиране RELEASE_VERSION е зададено на latest, което означава, че сървърът ще изтегли и инсталира най-новата версия, налична на вашия избран клон, всеки път, когато сървърът се стартира (ако е налична по-нова версия). За да предотвратите автоматичните актуализации и да заключите сървъра си към конкретна версия:

Отидете в таб Startup в GPanel.
Променете RELEASE_VERSION от latest на точния номер на версията, която искате (напр. 1.19.8).
Рестартирайте сървъра. Той ще използва само фиксираната версия, независимо от по-новите издания.

Съвместимост с модове: Ако използвате модове, се препоръчва фиксиране на конкретна версия. Актуализациите на играта могат да нарушат съвместимостта с модовете, а актуализирането по средата на игра може да причини проблеми. Проверете дали вашите модове поддържат целевата версия преди актуализиране. Вижте Инсталиране на модове за Vintage Story за подробности.

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

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, използван за генериране на света. Същият seed произвежда същия свят. Оставете като празен низ за случаен 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: Определя оформлението на терена, разположението на биомите и разпределението на ресурсите. Задайте конкретен seed, за да споделите същото оформление на света с други, или го оставете празен за случайно генериран свят.
MapSizeX / MapSizeZ: Контролират максималната играема област. По-малки стойности създават по-ограничен свят и могат да намалят използването на ресурси. Играчите, които достигнат ръба на картата, няма да могат да пътуват по-нататък в тази посока.
WorldConfig: Обектът WorldConfig в serverconfig.json ви позволява да настроите фино параметрите за генериране на света, като скала на ландшафта, климатични модели и геоложки характеристики. Това са разширени настройки -- стандартните стойности работят добре за повечето сървъри.

Настройките за генериране на свят са заключени след създаването. Настройки като WorldSeed, MapSizeX и MapSizeZ влизат в сила само когато светът се генерира за първи път. За да приложите нови настройки за генериране, трябва да създадете нов свят (вижте Управление на запазвания по-долу).

Избор на seed

Seed може да бъде всеки текстов низ или число. Играчите в общността на Vintage Story споделят seed-ове за интересни оформления на свят. Ако искате конкретен тип терен или локация за спауниране, потърсете във форумите на Vintage Story или в сайтовете на общността препоръчителни seed-ове.

Как да се свържете

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

Direct Connect

Стартирайте 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 сървър - База знания

Support

Categories

Ръководство за настройка на Vintage Story сървър