Ten przewodnik obejmuje sposób konfiguracji dedykowanego serwera Portal Knights w Legion Hosting, ustawianie zmiennych startowych, dostosowywanie ustawień serwera, łączenie się ze znajomymi oraz zarządzanie zapisami świata. Aby uzyskać informacje o kontroli administratora i zarządzaniu graczami, zobacz Komendy administratora Portal Knights.

1. Pierwsze uruchomienie

1. Zaloguj się do GPanel i wybierz swój serwer Portal Knights.
2. Przejdź do zakładki Startup i przejrzyj dostępne zmienne (zobacz tabelę poniżej).
3. Ustaw SERVER_NAME, abyś mógł zidentyfikować swój serwer w przeglądarce.
4. Zmień ADMIN_PASS z wartości domyślnej. Opcjonalnie ustaw USER_PASS lub GUEST_PASS, aby ograniczyć dostęp do swojej grupy.
5. Wróć do zakładki Console i kliknij Start.
6. Poczekaj, aż konsola wskaże, że serwer zakończył ładowanie. Pierwsze uruchomienie wygeneruje domyślne pliki konfiguracyjne i nowy świat.

2. Zmienne startowe GPanel

Następujące zmienne są dostępne w zakładce Startup w GPanel. Te wartości są stosowane przy każdym uruchomieniu serwera.

3. Konfiguracja serwera

Poza zmiennymi startowymi Portal Knights umożliwia precyzyjne dostrojenie poprzez plik konfiguracyjny serwera. Zatrzymaj serwer przed wprowadzeniem zmian.

Lokalizacja pliku konfiguracyjnego

dedicated_server/server_config.json

Otwórz ten plik za pomocą zakładki Files w GPanel lub połącz się przez SFTP. Jeśli plik nie istnieje, uruchom i zatrzymaj serwer raz, aby wygenerować go z domyślnymi wartościami.

Kluczowe ustawienia

Plik konfiguracyjny używa formatu JSON. Kluczowe właściwości obejmują:

Przykładowa konfiguracja

{
  "basicServerData": {
    "name": "My Portal Knights Server",
    "ipv4": "0.0.0.0",
    "port": 27015,
    "saveFolderPath": "./savedata"
  },
  "admins": {
    "credentials": {
      "password": "my_admin_password"
    }
  },
  "users": {
    "credentials": {
      "password": ""
    }
  },
  "guests": {
    "credentials": {
      "password": ""
    }
  },
  "gameplayMode": "Adventure",
  "universeSize": "Normal",
  "hideConsoleWindow": true
}

4. Ustawienia świata

Światy Portal Knights składają się z proceduralnie generowanych wysp połączonych portalami. Kluczowe kwestie związane ze światem:

• Folder zapisu: Dane świata są przechowywane w katalogu savedata (konfigurowanym za pomocą basicServerData.saveFolderPath w konfiguracji).
• Tryb rozgrywki: Ustawiany za pomocą zmiennej startowej GAMEMODE. Adventure to standardowe doświadczenie RPG; Creative umożliwia swobodne budowanie i eksplorację.
• Rozmiar uniwersum: Ustawiany za pomocą zmiennej startowej UNIVERSE_SIZE. Kontroluje liczbę wysp: Small, Normal lub Large.
• Postęp na wyspach: Gracze przechodzą przez wyspy, zbierając fragmenty portali i aktywując portale. Serwer śledzi wszystkie odkryte wyspy i ich stany.

5. Jak się połączyć

Opcja A -- Przeglądarka serwerów w grze

1. Uruchom Portal Knights przez Steam.
2. Z menu głównego wybierz Multiplayer.
3. Wybierz Online Game, a następnie Browse Servers.
4. Wyszukaj swój serwer po nazwie lub przeglądaj listę.
5. Wybierz swój serwer i kliknij Join. Wprowadź hasło, jeśli zostaniesz o to poproszony.

Opcja B -- Bezpośrednie połączenie przez IP

1. Uruchom Portal Knights przez Steam.
2. Z menu głównego wybierz Multiplayer.
3. Wybierz Online Game, a następnie Direct Connect.
4. Wprowadź IP i port serwera z zakładki Network w GPanel:

   <your-server-ip>:<port>

5. Wprowadź hasło serwera, jeśli zostało ustawione.

6. Zarządzanie zapisami

Lokalizacja pliku zapisu

Zapisy świata są przechowywane na serwerze w:

dedicated_server/savedata/

Ta ścieżka jest konfigurowana za pomocą ustawienia basicServerData.saveFolderPath w server_config.json.

Ręczne kopie zapasowe przez SFTP

1. Zatrzymaj serwer z poziomu GPanel, aby zapewnić zapisanie wszystkich danych na dysk.
2. Połącz się ze swoim serwerem przez SFTP. Instrukcje znajdziesz w Jak przesyłać pliki przez SFTP.
3. Przejdź do katalogu dedicated_server/savedata/.
4. Pobierz cały folder świata, którego kopię zapasową chcesz utworzyć.

Przywracanie zapisu

1. Zatrzymaj serwer z poziomu GPanel.
2. Połącz się przez SFTP i przejdź do dedicated_server/savedata/.
3. Prześlij folder świata z kopii zapasowej, zastępując istniejący w razie potrzeby.
4. Upewnij się, że nazwa folderu odpowiada ustawieniu world_name w Twojej konfiguracji.
5. Uruchom serwer z poziomu GPanel.

Rozwiązywanie problemów

• Serwer nie pojawia się w przeglądarce: Potwierdź, że serwer jest w pełni uruchomiony w GPanel. Przeglądarka serwerów może potrzebować 2-3 minut na zindeksowanie nowego serwera. W międzyczasie spróbuj bezpośredniego połączenia przez IP.
• Nie można się połączyć: Sprawdź IP i port serwera w zakładce Network w GPanel. Upewnij się, że serwer działa i nie jest w stanie awarii.
• Awarie przy uruchomieniu: Usuń plik konfiguracyjny i uruchom ponownie, aby ponownie wygenerować ustawienia domyślne. Jeśli problem się utrzymuje, sprawdź konsolę GPanel pod kątem komunikatów o błędach.
• Świat się nie wczytuje: Upewnij się, że ustawienie basicServerData.saveFolderPath w server_config.json wskazuje na poprawny katalog.

Powiązane artykuły

• Komendy administratora Portal Knights
• Jak znaleźć IP i port swojego serwera
• Jak przesyłać pliki przez SFTP
• Przewodnik uruchamiania serwera

Potrzebujesz pomocy?

Jeśli napotkasz problemy nieomówione tutaj, otwórz zgłoszenie do pomocy technicznej i podaj IP serwera, opis problemu oraz wszelkie komunikaty o błędach z konsoli GPanel.