server.properties w Minecraft Java – konfiguracja serwera krok po kroku

Plik server.properties jest jednym z najważniejszych plików konfiguracyjnych serwera Minecraft Java. To właśnie w nim ustawisz między innymi port, tryb gry, poziom trudności, PvP, whitelistę, odległość renderowania oraz sposób generowania świata. Dobrze przygotowana konfiguracja pomaga dopasować serwer do liczby graczy i dostępnych zasobów hostingu.

W tym poradniku pokazujemy, jak bezpiecznie edytować server.properties na serwerze Minecraft Java. Przykłady dotyczą współczesnych wydań serwera Java z linii 26.x. Nazwy części właściwości mogą zmieniać się między wersjami lub różnić w silnikach takich jak Paper, dlatego po aktualizacji warto porównać plik z dokumentacją używanego oprogramowania.

Gdzie znajduje się plik server.properties?

Plik znajduje się w głównym katalogu serwera, czyli zwykle w tym samym miejscu co plik JAR, katalog world oraz foldery logs i libraries. Na hostingu otworzysz go zazwyczaj z poziomu menedżera plików w panelu klienta albo po połączeniu przez SFTP.

Przed zmianami zatrzymaj serwer. Edycja pliku podczas działania może zostać nadpisana przy wyłączaniu procesu, a część ustawień zostanie odczytana dopiero po ponownym uruchomieniu. Wykonaj również kopię zapasową pliku, na przykład jako server.properties.backup.

Jak edytować server.properties krok po kroku?

1. Zatrzymaj serwer Minecraft w panelu klienta i poczekaj, aż konsola przestanie generować nowe wpisy.
2. Otwórz menedżer plików lub połącz się z serwerem przez SFTP.
3. Przejdź do głównego katalogu instancji i pobierz kopię pliku server.properties.
4. Edytuj plik w edytorze tekstowym obsługującym zwykły tekst, na przykład Notepad++ albo VS Code.
5. Zmieniaj wyłącznie wartość po znaku =. Nie usuwaj nazwy właściwości ani separatora.
6. Zapisz plik w kodowaniu UTF-8, prześlij go z powrotem na serwer i potwierdź zastąpienie poprzedniej wersji.
7. Uruchom serwer i sprawdź konsolę. Jeżeli serwer nie startuje, przywróć kopię zapasową oraz przejrzyj logi.

W pliku znak # na początku wiersza oznacza komentarz. Standardowe wpisy mają format nazwa=wartość. Nie dodawaj spacji przed nazwą właściwości, ponieważ niektóre silniki mogą potraktować taki wiersz jako nieznany.

Najważniejsze ustawienia server.properties

Port i adres serwera

Właściwość server-port określa port, na którym serwer nasłuchuje połączeń. Na hostingu ustaw ją zgodnie z portem przydzielonym do konkretnej instancji. Przykład:

server-port=25565

Jeśli hosting przypisał inny port, nie zamieniaj go samodzielnie na domyślny. Port musi być zgodny z konfiguracją usługi, a gracze powinni łączyć się z adresem i portem podanym w panelu. Właściwość server-ip najczęściej pozostawia się pustą. Wpisanie przypadkowego adresu może spowodować, że serwer nie będzie mógł otworzyć portu.

Tryb gry, trudność i PvP

Za podstawowe zasady rozgrywki odpowiadają między innymi:

• gamemode – domyślny tryb nowych graczy, na przykład survival, creative, adventure lub spectator,
• difficulty – poziom trudności: peaceful, easy, normal albo hard,
• pvp – możliwość zadawania obrażeń innym graczom,
• force-gamemode – wymuszanie domyślnego trybu po wejściu na serwer.

gamemode=survival
difficulty=normal
pvp=true
force-gamemode=false

Zmiana gamemode nie zawsze przełączy tryb osobom, które już wcześniej grały. Do jednorazowej zmiany konkretnego gracza użyj komendy /gamemode z odpowiednimi uprawnieniami.

Whitelist i dostęp do serwera

Jeżeli serwer ma być prywatny, włącz whitelistę:

white-list=true

Następnie dodaj graczy komendą /whitelist add nick z poziomu konsoli lub gry, jeśli masz uprawnienia operatora. W nowszych wydaniach domyślna wartość tego ustawienia może różnić się od starszych wersji, dlatego po aktualizacji sprawdź ją w wygenerowanym pliku.

Nie traktuj online-mode=false jako sposobu na naprawę problemów z logowaniem. Wyłączenie weryfikacji kont może obniżyć bezpieczeństwo i powinno być stosowane wyłącznie wtedy, gdy rozumiesz konsekwencje oraz korzystasz z poprawnie zabezpieczonego rozwiązania pośredniczącego.

Wydajność: view-distance i simulation-distance

Największy wpływ na obciążenie serwera mają często odległości renderowania i symulacji:

• view-distance określa, ile chunków serwer wysyła graczowi,
• simulation-distance określa, jak daleko od gracza świat aktywnie wykonuje obliczenia.

Wyższe wartości zwiększają widoczny obszar, ale mogą podnieść zużycie pamięci i CPU. Dla małego serwera zacznij od umiarkowanych wartości, na przykład:

view-distance=8
simulation-distance=6

Jeśli gracze zgłaszają opóźnienia, zmniejsz najpierw simulation-distance, a dopiero potem view-distance. Po każdej zmianie obserwuj TPS, zużycie pamięci i czas odpowiedzi serwera. Samo zwiększenie pamięci RAM nie rozwiąże problemu, jeśli przyczyną jest zbyt duża liczba aktywnych chunków, mobów lub redstone.

Świat i generowanie mapy

Właściwość level-name wskazuje nazwę katalogu świata. Zmieniaj ją tylko wtedy, gdy chcesz uruchomić inną, już istniejącą mapę. level-seed określa ziarno używane przy generowaniu nowego świata. Ustawienie seeda nie przebuduje istniejącej mapy — zadziała dopiero podczas tworzenia świata, którego katalog jeszcze nie istnieje.

Przy zmianach związanych ze światem zachowaj szczególną ostrożność. Przed podmianą mapy wykonaj pełną kopię katalogu świata, a nie tylko samego pliku konfiguracyjnego.

Komendy i komunikaty

enable-command-block kontroluje działanie command blocków. Jeśli mapa korzysta z datapacków lub mechanizmów automatyzacji, wyłączenie tej opcji może przerwać ich działanie. Z kolei motd ustawia opis widoczny na liście serwerów. Wartość może zawierać kody kolorów obsługiwane przez konkretny silnik, jednak przed użyciem niestandardowych formatów sprawdź dokumentację wersji.

Przykładowa bezpieczna konfiguracja startowa

Poniższy fragment jest punktem wyjścia dla niewielkiego serwera survival. Nie wklejaj go bez sprawdzenia portu przydzielonego przez hosting:

motd=Vorlantix Minecraft
gamemode=survival
difficulty=normal
pvp=true
white-list=true
view-distance=8
simulation-distance=6
server-ip=
server-port=25565
enable-command-block=false

Ustawienia dotyczące pluginów lub modów mogą być przechowywane w osobnych plikach. Zmiana server.properties nie zastąpi konfiguracji Paper, Forge, Fabric ani poszczególnych pluginów.

Najczęstsze problemy

Serwer nie uruchamia się po zapisaniu pliku

Sprawdź, czy każda linia ma poprawny format i czy wartości są zgodne z wersją serwera. Usuń przypadkowe cudzysłowy, polskie znaki w nazwach kluczy oraz dodatkowe znaki skopiowane z edytora. Jeśli problem nadal występuje, przywróć kopię i zmieniaj ustawienia pojedynczo.

Gracze nie mogą się połączyć

Porównaj server-port z portem widocznym w panelu. Upewnij się, że serwer jest uruchomiony, a gracze używają właściwej wersji Minecraft Java. Nie wpisuj adresu domeny do server-ip; zwykle pole powinno pozostać puste.

Zmiana nie działa

Zatrzymaj serwer przed edycją, zapisz plik w katalogu właściwej instancji i uruchom serwer ponownie. Sprawdź również, czy plugin, mod albo ustawienie świata nie nadpisuje danej wartości. Niektóre parametry są odczytywane tylko przy starcie.

Serwer działa, ale pojawiają się lagi

Zmniejsz simulation-distance i view-distance, ogranicz liczbę ciężkich farm oraz sprawdź logi. Jeżeli problem występuje tylko w jednym miejscu mapy, przyczyną może być obciążający mechanizm, plugin albo uszkodzone chunki, a nie sam plik server.properties.

Podsumowanie

server.properties pozwala ustawić najważniejsze zasady działania serwera Minecraft Java bez edytowania kodu i bez przebudowy całej instancji. Najbezpieczniejszy schemat to: zatrzymaj serwer, wykonaj kopię, zmień jedną grupę ustawień, uruchom instancję i sprawdź logi. Zacznij od portu, whitelisty, trybu gry oraz odległości renderowania, a przy aktualizacji zawsze uwzględnij różnice między wersjami.