Przewodnik konfiguracji serwera Starbound
Ten przewodnik opisuje konfigurowanie i ustawianie dedykowanego serwera Starbound w Legion Hosting, w tym wymagania dotyczące uwierzytelniania Steam, pierwsze uruchomienie, konfigurację serwera, ustawienia uniwersum, łączenie graczy oraz zarządzanie zapisami. Informacje o instalacji modów znajdziesz w artykule Instalacja modów Starbound. Informacje o komendach i uprawnieniach administracyjnych znajdziesz w artykule Komendy administracyjne Starbound.
Wymagania wstępne
Przed uruchomieniem serwera Starbound musisz spełnić następujące warunki:
- Konto Steam posiadające Starbound. Plik binarny serwera nie jest dostępny do anonimowego pobierania -- konto, które podasz, musi mieć Starbound w swojej bibliotece.
- Kwestie związane ze Steam Guard. Jeśli Twoje konto Steam ma włączony Steam Guard (uwierzytelnianie dwuskładnikowe), będziesz musiał podać kod uwierzytelniający za pomocą zmiennej startowej
STEAM_AUTHpodczas pierwszej instalacji. Po początkowym uwierzytelnieniu SteamCMD buforuje sesję i kolejne uruchomienia nie powinny ponownie wymagać kodu, chyba że bufor wygaśnie. - Zalecane dedykowane konto Steam. Ze względów bezpieczeństwa rozważ użycie osobnego konta Steam posiadającego Starbound wyłącznie do hostingu serwera. Pozwala to uniknąć udostępniania danych logowania głównego konta i zapobiega konfliktom, jeśli chcesz jednocześnie grać na tym samym koncie.
Pierwsze uruchomienie
Po zakupie serwera Starbound w Legion Hosting wykonaj poniższe kroki, aby uruchomić go po raz pierwszy:
- Zaloguj się do GPanel i wybierz swój serwer Starbound.
- Przejdź do zakładki Startup.
- Wypełnij wymagane dane logowania Steam:
- STEAM_USER -- Nazwa użytkownika Twojego konta Steam (wymagane).
- STEAM_PASS -- Hasło do Twojego konta Steam (wymagane).
- STEAM_AUTH -- Twój kod 2FA Steam Guard, jeśli zostaniesz o niego poproszony (opcjonalne, potrzebne tylko przy pierwszej instalacji lub gdy buforowana sesja wygaśnie).
- Przejdź do zakładki Console i kliknij Start.
- Serwer pobierze pliki dedykowanego serwera Starbound za pomocą SteamCMD. Przy pierwszym uruchomieniu może to potrwać kilka minut.
- Po zakończeniu pobierania serwer wygeneruje domyślne uniwersum i zacznie nasłuchiwać połączeń.
STEAM_AUTH i zrestartuj serwer. Sprawdź swój e-mail lub aplikację uwierzytelniającą, aby znaleźć kod. Zazwyczaj wystarczy zrobić to raz -- SteamCMD zbuforuje sesję na potrzeby przyszłych uruchomień.
Zmienne startowe GPanel
| Zmienna | Wymagana | Opis |
|---|---|---|
STEAM_USER |
Tak | Nazwa użytkownika konta Steam. Musi posiadać Starbound. Nie może być anonymous. |
STEAM_PASS |
Tak | Hasło konta Steam dla powyższej nazwy użytkownika. |
STEAM_AUTH |
Nie | Kod uwierzytelniania dwuskładnikowego Steam Guard. Potrzebny tylko podczas początkowej konfiguracji lub gdy buforowana sesja wygaśnie. |
WORKSHOP |
Nie | Ustaw na 1, aby włączyć obsługę modów ze Steam Workshop, lub na 0, aby ją wyłączyć. Wartość domyślna to 0. Szczegóły znajdziesz w artykule Instalacja modów Starbound. |
starbound_server.config
Główny plik konfiguracyjny serwera znajduje się w:
storage/starbound_server.config
Ten plik używa formatu JSON. Edytuj go za pomocą Menedżera plików w GPanel lub przez SFTP. Przed edycją serwer musi być zatrzymany, ponieważ zmiany są ładowane podczas uruchamiania.
Kluczowe ustawienia serwera
| Ustawienie | Domyślne | Opis |
|---|---|---|
serverName |
"A Starbound Server" |
Nazwa wyświetlana w przeglądarce serwerów oraz podczas łączenia się graczy. |
maxPlayers |
8 |
Maksymalna liczba graczy, którzy mogą być połączeni jednocześnie. |
gameServerPort |
21025 |
Port, na którym nasłuchuje serwer gry. W Legion Hosting jest ustawiany automatycznie -- nie zmieniaj go, chyba że poleci to wsparcie. |
gameServerBind |
"::" |
Interfejs sieciowy, do którego ma się powiązać. Domyślna wartość "::" wiąże się ze wszystkimi interfejsami (IPv4 i IPv6). Pozostaw bez zmian. |
serverPassword |
"" |
Hasło wymagane do dołączenia do serwera. Pozostaw puste, aby nie było hasła (publiczny dostęp). |
allowAnonymousConnections |
true |
Gdy true, gracze mogą się łączyć bez konta Starbound. Ustaw na false, aby wymagać uwierzytelnienia konta od wszystkich graczy. |
allowAssetsMismatch |
true |
Gdy true, gracze z różnymi zestawami modów nadal mogą się łączyć. Ustaw na false, aby wymusić zgodność zasobów między serwerem a klientem (zalecane dla serwerów z modami). |
maxTeamSize |
4 |
Maksymalna liczba graczy w drużynie/grupie. |
clientIPJoinable |
false |
Określa, czy można dołączyć do serwera za pośrednictwem bezpośredniego IP. Dla serwerów dedykowanych powinno być true. |
clientP2PJoinable |
false |
Określa, czy dozwolone są połączenia peer-to-peer. Zazwyczaj false dla serwerów dedykowanych. |
Przykładowy plik starbound_server.config
{
"serverName" : "My Legion Starbound Server",
"maxPlayers" : 8,
"gameServerBind" : "::",
"serverPassword" : "",
"allowAnonymousConnections" : true,
"allowAssetsMismatch" : true,
"maxTeamSize" : 4,
"clientIPJoinable" : true,
"clientP2PJoinable" : false,
"allowAdminCommands" : true,
"allowAdminCommandsFromAnyone" : false,
"serverUsers" : {
"YourUsername" : {
"admin" : true,
"password" : "your-admin-password"
}
}
}
Ustawienia świata i uniwersum
Starbound korzysta z proceduralnie generowanego uniwersum. Za każdym razem, gdy gracz odwiedza nowy układ gwiezdny lub planetę, gra generuje je na podstawie ziarna uniwersum i układu współrzędnych. Dane uniwersum serwera są przechowywane w:
storage/universe/
Ten katalog zawiera wszystkie wygenerowane dane świata, w tym planety, stacje kosmiczne oraz konstrukcje zbudowane przez graczy umieszczone w świecie.
Konfiguracja uniwersum
Parametry generowania uniwersum można dostosować w pliku starbound_server.config lub za pomocą plików zasobów związanych z uniwersum. Kluczowe pojęcia:
| Pojęcie | Opis |
|---|---|
| Ziarno uniwersum | Uniwersum jest generowane proceduralnie na podstawie współrzędnych. Wszystkie serwery z tą samą wersją gry wygenerują identyczne planety przy tych samych współrzędnych, ale obiekty umieszczone przez graczy i modyfikacje są unikalne dla każdego serwera. |
| Planeta startowa | Nowi gracze pojawiają się na proceduralnie wybranej planecie startowej. Świat startowy to planeta typu ogrodowego, odpowiednia do wczesnego etapu rozgrywki. |
| Pliki świata | Każda odwiedzona planeta generuje plik .world w katalogu storage/universe/. Te pliki zawierają modyfikacje terenu, umieszczone obiekty oraz zmiany kafelków dokonane przez graczy. |
| Dane astralne | Pliki universe.chunks i universe.dat w katalogu uniwersum przechowują ogólny stan mapy uniwersum. |
storage/universe/. Pamiętaj, że spowoduje to usunięcie wszystkich wygenerowanych światów, w tym wszelkich konstrukcji zbudowanych przez graczy. Zawsze twórz kopię zapasową przed wykonaniem tej operacji.
Jak się połączyć
Gracze łączą się z Twoim serwerem Starbound za pomocą menu trybu wieloosobowego w grze.
Bezpośrednie połączenie przez IP
- Uruchom Starbound.
- W menu głównym kliknij Multiplayer.
- Wybierz swoją postać.
- W polu Server Address wpisz adres IP i port serwera w formacie:
IP:Port - Jeśli serwer ma ustawione hasło, wprowadź Account Name i Password odpowiadające wpisowi
serverUsersw konfiguracji serwera. JeśliallowAnonymousConnectionsma wartośćtruei nie ustawiono hasła serwera, te pola można pozostawić puste. - Kliknij Join Server.
Znajomi Steam (nie dotyczy)
Funkcja Steam „Join Game" jest przeznaczona dla gier hostowanych w trybie peer-to-peer, a nie dla serwerów dedykowanych. Gracze muszą używać opisanej powyżej metody bezpośredniego połączenia przez IP, aby dołączyć do Twojego serwera Legion Hosting.
- Serwer jest uruchomiony i w pełni wystartował (sprawdź konsolę GPanel pod kątem „Info: Server listened on").
- Używany jest prawidłowy adres IP i port.
- Jeśli używane jest hasło serwera, gracz wprowadza prawidłowe dane logowania
serverUsers. - Jeśli
allowAssetsMismatchma wartośćfalse, zainstalowane mody gracza muszą dokładnie odpowiadać modom serwera. - Zarówno serwer, jak i klient działają na tej samej wersji Starbound.
Zarządzanie zapisami
Starbound przechowuje wszystkie dane serwera w katalogu storage/. Zrozumienie struktury plików pomaga w tworzeniu kopii zapasowych, przenoszeniu i rozwiązywaniu problemów.
Kluczowe katalogi i pliki magazynu
| Ścieżka | Opis |
|---|---|
storage/universe/ |
Zawiera wszystkie wygenerowane dane świata -- planety, stacje kosmiczne oraz modyfikacje świata dokonane przez graczy. Każda odwiedzona planeta ma plik .world. |
storage/player/ |
Zawiera pliki zapisów graczy. Każdy gracz ma plik .player przechowujący jego ekwipunek, postęp, stan zadań oraz dane statku. |
storage/starbound_server.config |
Główny plik konfiguracyjny serwera. |
storage/starbound_server.log |
Plik dziennika serwera. Przydatny do diagnozowania awarii, błędów i problemów z połączeniem. |
Tworzenie kopii zapasowych
Regularne kopie zapasowe chronią uniwersum, dane graczy i konfigurację serwera przed przypadkową utratą lub uszkodzeniem.
- Zatrzymaj serwer w GPanel, aby upewnić się, że wszystkie dane zostały zapisane na dysku.
- Połącz się z serwerem przez SFTP lub użyj Menedżera plików.
- Pobierz cały katalog
storage/na swój lokalny komputer. - Przechowuj kopię zapasową w bezpiecznym miejscu z etykietą daty (np.
storage-backup-2026-02-26).
storage/universe/ i storage/player/. Zawierają one wszystkie dane świata i postępu graczy. Powinieneś również utworzyć kopię zapasową pliku starbound_server.config, aby zachować ustawienia serwera.
Przywracanie z kopii zapasowej
- Zatrzymaj serwer.
- Prześlij pliki kopii zapasowej do odpowiednich lokalizacji w katalogu
storage/, nadpisując istniejące pliki. - Uruchom serwer.
Przenoszenie świata z innego serwera
Aby przenieść swoje uniwersum Starbound z innego serwera lub lokalnej gry:
- Zatrzymaj zarówno serwer źródłowy, jak i docelowy.
- Skopiuj katalog
storage/universe/z serwera źródłowego na serwer docelowy. - Opcjonalnie skopiuj
storage/player/, jeśli chcesz również przenieść dane graczy. - Skopiuj plik
starbound_server.config, aby zachować ustawienia serwera. - Uruchom serwer docelowy i sprawdź, czy świat ładuje się poprawnie.
Powiązane artykuły
- Instalacja modów Starbound
- Komendy administracyjne Starbound
- Jak znaleźć adres IP i port serwera
- Jak przesyłać pliki przez SFTP
- Przewodnik uruchamiania serwera
Potrzebujesz pomocy?
Jeśli napotkasz problemy nieomówione w tym przewodniku, nasz zespół wsparcia jest gotowy do pomocy. Otwórz zgłoszenie na legionhosting.net/submitticket.php, podając szczegóły serwera oraz opis problemu.