Jak zainstalować i skonfigurować TShock na serwerze Terraria?

Na Vorlantix instalujesz TShock przez wybór odpowiedniego wydania w polu Wersja Terraria. Po uruchomieniu usługi odczytaj kod pierwszej konfiguracji w logach, dołącz do gry i utwórz konto właściciela. Następnie ustaw nazwę, zasady dostępu i kopie zapasowe. Nie musisz samodzielnie instalować środowiska uruchomieniowego na maszynie hostingu.

TShock przydaje się, gdy chcesz zarządzać kontami, grupami i uprawnieniami albo korzystać z pluginów. Ten poradnik prowadzi przez podstawową konfigurację nowego serwera. Procedurę konta i przykładowe ustawienia zweryfikowano dla TShock 6.2.1, przeznaczonego dla Terraria 1.4.5.8. W instalatorze wybieraj dostępne wydanie zgodne z grą uczestników; starsza pozycja może mieć inne szczegóły konfiguracji. Powiązanie wersji sprawdzisz w oficjalnych wydaniach projektu.

Co przygotować przed instalacją TShock?

• Aktywny hosting Terraria: potrzebujesz dostępu do panelu klienta Vorlantix.
• Zgodną wersję gry: porównaj pełny numer Terrarii z wydaniem obsługiwanym przez TShock.
• Dane konta właściciela: przygotuj własny login i długie, unikalne hasło.
• Kopię istniejących danych: jeśli zmieniasz działający serwer, zabezpiecz świat i konfigurację przed reinstalacją.

Jeśli to nowa usługa, zacznij od standardowych ustawień bez dodatkowych pluginów. Najpierw sprawdzisz podstawową rozgrywkę i logowanie, a dopiero później rozszerzysz możliwości serwera. Przy przejściu z istniejącego TShock zachowaj również bazę danych i dane rozszerzeń — sam zapis świata nie obejmuje całej administracji.

Krok 1. Wybierz TShock w instalatorze Vorlantix

1. Zaloguj się do panelu klienta i otwórz Serwery gier.
2. Wybierz nową usługę Terraria i przejdź do instalacji.
3. W polu Wersja Terraria wskaż wariant oznaczony jako TShock.
4. Sprawdź numer obsługiwanej Terrarii. Numer TShock i numer gry to dwie różne informacje.
5. Wybierz Wielkość świata: mały, średni lub duży.
6. Zatwierdź instalację i zaczekaj na zakończenie operacji.

Wariant wybiera się na liście wersji, a nie w osobnym polu silnika. Formularz Terrarii nie tworzy też konta administratora TShock. Ten etap wykonasz po uruchomieniu oprogramowania.

Jeżeli najnowszego wydania TShock nie ma na liście, nie zakładaj, że inna pozycja obsługuje tę samą Terrarię. Dobierz zgodne wydanie lub skontaktuj się z pomocą Vorlantix. Nie kopiuj przypadkowych plików programu do działającej instalacji w ramach próby aktualizacji.

Krok 2. Uruchom usługę i odczytaj kod konfiguracji

Po instalacji otwórz zakładkę Konsola. Jeśli serwer jest zatrzymany, kliknij Start i poczekaj na przygotowanie świata. W logach sprawdź, czy faktycznie uruchomił się TShock oraz czy nie ma błędów.

Przy nowej instalacji bez utworzonych kont TShock wyświetla instrukcję pierwszej konfiguracji i kod do polecenia /setup. Zachowaj kod tylko dla siebie. To dostęp do procedury nadania uprawnień, a nie hasło przeznaczone dla znajomych.

W TShock 6.2.1 kod może być również zapisany w pliku setup-code.txt w katalogu danych TShock. Istniejące konto lub blokada zakończonej konfiguracji mogą wyłączać tę procedurę. Mechanizm opisuje kod pierwszego uruchomienia TShock. Nie usuwaj bazy użytkowników, żeby wymusić ponowne pojawienie się kodu.

Krok 3. Połącz się z serwerem Terraria

Na stronie usługi odszukaj sekcję Jak połączyć się z serwerem?. Uruchom zgodną Terrarię, wybierz Multiplayer → Join via IP i wskaż postać. Wpisz adres hosta z panelu, a w kolejnym kroku osobno przypisany port.

Nie używaj adresu strony WWW hostingu zamiast hosta gry. Nie zastępuj też przydzielonego portu wartością domyślną z innego poradnika. Gdy pojawisz się w świecie, otwórz czat gry — tam wykonasz kolejne polecenia.

Krok 4. Utwórz konto właściciela TShock

Poniższe polecenia wpisuj na czacie w grze, kolejno i po odczytaniu odpowiedzi. Zastąp kod, login oraz hasło własnymi wartościami. Konto w przykładzie nazywa się Wlasciciel.

1. Uzyskaj tymczasowy dostęp kodem wyświetlonym przez serwer:

   /setup TWOJ_KOD

2. Utwórz konto w grupie właściciela:

   /user add Wlasciciel TWOJE_UNIKALNE_HASLO owner

3. Zaloguj się na utworzone konto:

   /login Wlasciciel TWOJE_UNIKALNE_HASLO

4. Po potwierdzeniu logowania zakończ tryb pierwszej konfiguracji:

   /setup

Nie pomijaj ostatniego kroku. Tymczasowe uprawnienia z kodu nie zastępują trwałego konta. Następnie rozłącz się i sprawdź ponowne logowanie. Polecenia oraz zamknięcie procedury potwierdza implementacja komend TShock 6.2.1.

Hasło konta TShock przechowuj osobno od hasła panelu hostingu. Nie wysyłaj zrzutów czatu ani logów zawierających dane dostępu. Do codziennej gry znajomi nie potrzebują Twojego konta właściciela.

Krok 5. Ustaw nazwę serwera i podstawową konfigurację

Otwórz zakładkę Pliki w panelu Vorlantix i odszukaj aktywny plik config.json TShock. Typowa lokalizacja w instalacji to tshock/config.json, ale katalog udostępniony w panelu może wyglądać inaczej. Sprawdź logi, jeśli oprogramowanie korzysta z niestandardowej ścieżki.

Pobierz kopię pliku. Zapisz świat, zatrzymaj usługę, a następnie edytuj istniejącą konfigurację. Dla pierwszego startu wystarczy kilka ustawień:

Przykładowe wartości do ustawienia w odpowiednich polach istniejącego pliku:

"ServerName": "Nasza Terraria",
"UseServerName": true,
"AutoSave": true

To fragment, nie kompletny plik do podmiany. Zachowaj pozostałą strukturę JSON, przecinki i cudzysłowy. Nie dodawaj drugi raz tych samych kluczy. Opis parametrów znajduje się w konfiguracji TShock 6.2.1.

Nie zmieniaj portów przydzielonych przez hosting. Zapisz plik, uruchom usługę i sprawdź logi oraz dostęp z gry. Jeśli zmieniasz hasło dostępu, przetestuj je również na zwykłym koncie: mechanizmy logowania istniejących kont TShock mogą wpływać na przebieg dołączania.

Krok 6. Przygotuj konta graczy i sprawdź uprawnienia

Ustal, kto ma być właścicielem, kto moderatorem, a kto zwykłym graczem. Nie przydzielaj całej ekipie grupy właściciela tylko po to, aby ominąć komunikat odmowy. Najpierw zidentyfikuj brakujące uprawnienie i zdecyduj, czy dana osoba rzeczywiście go potrzebuje.

Na zalogowanym koncie administratora wpisz /user help, aby zobaczyć pomoc zarządzania kontami, oraz /help, aby sprawdzić dostępne komendy. Przykładowe przypisanie istniejącego konta do istniejącej grupy ma postać:

/user group LOGIN NAZWA_GRUPY

Przetestuj budowanie, czat i wybrane działania jako zwykły uczestnik. Test wykonany wyłącznie na właścicielu nie pokaże błędów dotyczących nowych graczy. Zapisz przyjęte zasady, aby później nie nadawać uprawnień przypadkowo.

Krok 7. Zdecyduj o SSC i dodawaj pluginy stopniowo

Server-Side Characters to opcjonalne przechowywanie danych postaci po stronie serwera. Nie włączaj tej funkcji tylko dlatego, że jest dostępna. Najpierw ustal, czy gracze mają korzystać z lokalnych bohaterów, czy zaczynać według zasad serwera.

SSC ma osobną konfigurację, z ustawieniem Enabled. W projekcie domyślna wartość to false; sprawdź jednak rzeczywisty plik swojej instalacji. Więcej informacji zawiera konfiguracja postaci serwerowych. Przed zmianą zabezpiecz bazę danych i przetestuj zachowanie ekwipunku na osobnym koncie.

Pluginy instaluj dopiero po sprawdzeniu podstaw. W zakładce Pliki możesz przesyłać pliki rozszerzeń do katalogu wskazanego w instrukcji danego pluginu i wydania serwera. Nie zgaduj ścieżki, jeśli panel pokazuje inną strukturę. Sprawdź zgodność wersji oraz zależności, zatrzymaj usługę przed zmianami i dodawaj po jednym rozszerzeniu. Po starcie przeczytaj logi.

Najczęstsze problemy

Nie ma kodu pierwszej konfiguracji

Sprawdź, czy działa TShock i czy instalacja nie zawiera wcześniejszych kont. Jeśli konto już istnieje, użyj go zamiast ponawiać procedurę nowego serwera. Przy utracie dostępu poproś o pomoc; kasowanie bazy może usunąć dane społeczności.

Komenda setup nie działa w panelu

Procedura pierwszego właściciela wymaga wejścia do świata. Kod wpisz na czacie gry, zgodnie z komunikatem startowym. Panel służy w tym kroku do odczytania logów i danych połączenia.

Po edycji konfiguracji serwer nie startuje

Sprawdź błąd w logach i poprawność JSON. Jeśli problem zaczął się po edycji, przy zatrzymanej usłudze odtwórz zachowaną kopię pliku. Zmieniaj niewiele parametrów naraz, aby łatwo wskazać przyczynę.

Gracz nie może budować lub ma inny ekwipunek

Sprawdź logowanie, grupę oraz konfigurację SSC. Odczytaj konkretny komunikat odmowy. Nie naprawiaj tego przez udostępnianie konta właściciela lub usuwanie danych postaci bez kopii.

Podsumowanie

Zacznij od wyboru zgodnego TShock w instalatorze Vorlantix. Po starcie odczytaj kod konfiguracji, dołącz do gry i utwórz trwałe konto właściciela. Następnie przygotuj nazwę, dostęp i uprawnienia, przetestuj zwykłego gracza oraz wykonaj kopię zapasową. SSC i pluginy dodawaj dopiero po sprawdzeniu podstaw, zachowując kopie świata, konfiguracji i bazy danych.