Przewodnik konfiguracji serwera Vintage Story

Ten przewodnik opisuje, jak skonfigurować i ustawić dedykowany serwer Vintage Story hostowany u Legion Hosting, w tym pierwsze uruchomienie, zmienne GPanel, zarządzanie wersjami, konfigurację serwera, ustawienia świata, łączenie graczy oraz zarządzanie zapisami. Informacje o instalacji modów znajdziesz w artykule Instalacja modów Vintage Story. Aby zapoznać się z konfiguracją administratora i komendami, zobacz Komendy administratora Vintage Story.

Pierwsze uruchomienie

Gdy uruchomisz serwer Vintage Story po raz pierwszy z GPanel, serwer automatycznie pobierze pliki gry z oficjalnego API Vintage Story i wygeneruje domyślny świat. To początkowe uruchomienie może potrwać kilka minut, podczas gdy pliki są pobierane i rozpakowywane.

1. Zaloguj się do GPanel i wybierz swój serwer Vintage Story.
2. Przed uruchomieniem przejrzyj zakładkę Startup, aby potwierdzić preferowaną gałąź wersji (stabilna, niestabilna lub przedpremierowa).
3. Kliknij Start w zakładce Console. Obserwuj dane wyjściowe konsoli pod kątem komunikatów o postępie, gdy serwer pobiera i instaluje pliki gry.
4. Gdy zobaczysz komunikat informujący, że serwer nasłuchuje połączeń, serwer jest gotowy. Domyślny plik serverconfig.json zostanie wygenerowany automatycznie.

Zmienne startowe GPanel

Główne ustawienia serwera są kontrolowane za pomocą zakładki Startup w GPanel. Przejrzyj je i dostosuj przed uruchomieniem serwera.

Po zaktualizowaniu zmiennych startowych zrestartuj serwer z GPanel, aby zmiany zostały zastosowane.

Zarządzanie wersjami

Vintage Story oferuje trzy gałęzie wydań. Twój wybór gałęzi jest ustawiany za pomocą zmiennej startowej FILES_BRANCH w GPanel.

Przypinanie konkretnej wersji

Domyślnie RELEASE_VERSION jest ustawione na latest, co oznacza, że serwer będzie pobierał i instalował najnowszą dostępną wersję na wybranej gałęzi za każdym razem, gdy serwer się uruchamia (jeśli dostępna jest nowsza wersja). Aby zapobiec automatycznym aktualizacjom i zablokować serwer na określonej wersji:

1. Przejdź do zakładki Startup w GPanel.
2. Zmień RELEASE_VERSION z latest na dokładny numer wersji, którego chcesz (np. 1.19.8).
3. Zrestartuj serwer. Będzie używał tylko przypiętej wersji niezależnie od nowszych wydań.

serverconfig.json

Głównym plikiem konfiguracyjnym serwera jest serverconfig.json, znajdujący się w katalogu głównym serwera. Plik ten jest generowany automatycznie przy pierwszym uruchomieniu. Zatrzymaj serwer przed jego edycją, a następnie zrestartuj, aby zmiany zostały zastosowane.

1. Zatrzymaj serwer z poziomu zakładki Console w GPanel.
2. Otwórz zakładkę Files i kliknij serverconfig.json, aby go edytować.
3. Zmodyfikuj potrzebne ustawienia (zobacz tabelę poniżej).
4. Zapisz plik i uruchom serwer.

Kluczowe ustawienia

Minimalny przykład kluczowych ustawień w serverconfig.json:

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

Konfiguracja świata

Vintage Story generuje swój świat na podstawie ustawień w serverconfig.json. Generowanie świata następuje tylko przy pierwszym uruchomieniu z danym światem -- zmiana ustawień generowania po utworzeniu świata nie zmieni z mocą wsteczną istniejącego terenu.

Ustawienia generowania świata

• WorldSeed: Określa układ terenu, rozmieszczenie biomów i rozkład zasobów. Ustaw konkretne ziarno, aby udostępnić ten sam układ świata innym, lub pozostaw je puste dla losowo generowanego świata.
• MapSizeX / MapSizeZ: Kontrolują maksymalny obszar rozgrywki. Mniejsze wartości tworzą bardziej ograniczony świat i mogą zmniejszyć zużycie zasobów. Gracze, którzy dotrą do krawędzi mapy, nie będą mogli podróżować dalej w tym kierunku.
• WorldConfig: Obiekt WorldConfig w pliku serverconfig.json pozwala precyzyjnie dostroić parametry generowania świata, takie jak skala ukształtowania terenu, wzorce klimatyczne i cechy geologiczne. Są to ustawienia zaawansowane -- wartości domyślne dobrze sprawdzają się dla większości serwerów.

Wybór ziarna

Ziarno może być dowolnym ciągiem tekstowym lub liczbą. Gracze w społeczności Vintage Story dzielą się ziarnami dla ciekawych układów świata. Jeśli chcesz określonego rodzaju terenu lub lokalizacji odrodzenia, przeszukaj fora Vintage Story lub strony społeczności w poszukiwaniu polecanych ziaren.

Jak się połączyć

Gracze łączą się z twoim serwerem Vintage Story za pomocą menu trybu wieloosobowego w grze.

Bezpośrednie połączenie

1. Uruchom Vintage Story i kliknij Multiplayer z menu głównego.
2. Kliknij Direct Connect.
3. Wprowadź adres IP serwera i port gry w formacie:

   your.server.ip:port

   Sprawdź zakładkę Network w GPanel, aby poznać przypisany adres IP i port.
4. Kliknij Connect. Jeśli serwer ma hasło, wprowadź je po wyświetleniu monitu.

Przeglądarka serwerów

1. Uruchom Vintage Story i kliknij Multiplayer z menu głównego.
2. Przeglądarka serwerów załaduje listę publicznych serwerów. Użyj paska wyszukiwania, aby znaleźć swój serwer po nazwie (wartość ServerName z serverconfig.json).
3. Kliknij swój serwer na liście i kliknij Join.

Zarządzanie zapisami

Dane świata Vintage Story są przechowywane na twoim serwerze i zapisywane automatycznie podczas rozgrywki.

Lokalizacja danych świata

Pliki zapisu świata są przechowywane w katalogu data/ na twoim serwerze. Dokładna ścieżka zależy od nazwy twojego świata. Możesz uzyskać dostęp do tych plików za pomocą zakładki Files w GPanel lub przez SFTP.

Tworzenie kopii zapasowej świata

1. Zatrzymaj serwer, aby zapewnić czystą kopię zapasową (żadne pliki nie są zapisywane w trakcie zapisu).
2. Połącz się z serwerem przez SFTP. Instrukcje połączenia znajdziesz w artykule Jak przesyłać pliki przez SFTP.
3. Pobierz cały katalog data/ na swój lokalny komputer.
4. Przechowuj kopię zapasową w bezpiecznym miejscu. Rozważ przechowywanie wielu datowanych kopii zapasowych na wypadek, gdybyś musiał przywrócić określony punkt.

Resetowanie świata

Aby rozpocząć całkowicie nowy świat:

1. Zatrzymaj serwer z poziomu zakładki Console w GPanel.
2. Wykonaj kopię zapasową istniejących danych świata, jeśli chcesz je zachować (zobacz powyżej).
3. Przejdź do katalogu data/ w menedżerze plików GPanel i usuń pliki zapisu świata.
4. Opcjonalnie zaktualizuj WorldSeed w serverconfig.json, aby wygenerować inny układ świata.
5. Uruchom serwer. Nowy świat zostanie wygenerowany od podstaw przy użyciu twoich aktualnych ustawień konfiguracji.

Powiązane artykuły

• Instalacja modów Vintage Story
• Komendy administratora Vintage Story
• Jak znaleźć adres IP i port serwera
• Jak przesyłać pliki przez SFTP
• Przewodnik uruchamiania serwera

Potrzebujesz pomocy?

Jeśli napotkasz problem, który nie został opisany w tym przewodniku, otwórz zgłoszenie do działu wsparcia i dołącz adres IP swojego serwera, opis problemu oraz wszelkie istotne dane wyjściowe z konsoli GPanel.