Konfiguracja server.properties

Czym jest server.properties?

Plik server.properties to główny plik konfiguracyjny serwera Minecraft Java Edition. Generuje się automatycznie przy pierwszym uruchomieniu serwera i znajduje się w katalogu głównym serwera, obok pliku server.jar. Każda linia zawiera jedną opcję w formacie klucz=wartość.

Edytujesz go zwykłym edytorem tekstu (Notepad++, VS Code, nano). Po każdej zmianie musisz zrestartować serwer, żeby nowe ustawienia zostały zastosowane. Linie zaczynające się od # to komentarze i serwer je ignoruje.

Wskazówka: Zanim zaczniesz modyfikować plik, zrób kopię zapasową. Wystarczy skopiować server.properties i nazwać kopię np. server.properties.bak. Jeśli coś popsujesz, masz do czego wrócić.

Jeśli nie masz jeszcze serwera, przejdź najpierw do naszego poradnika jak założyć serwer Minecraft, gdzie krok po kroku przeprowadzimy Cię przez cały proces.

Podstawowe ustawienia serwera

Te opcje decydują o podstawowym zachowaniu serwera. Od nich zacznij konfigurację.

motd Wiadomość widoczna na liście serwerów w kliencie gry (Message of the Day). Obsługuje kody kolorów z prefiksem \u00a7 (np. \u00a76Moj Serwer = złoty tekst). Maksymalnie 59 znaków. Użyj generatora MOTD online, żeby łatwo tworzyć kolorowe opisy z formatowaniem.

server-port Port, na którym nasłuchuje serwer. Domyślnie 25565. Zmień tylko wtedy, gdy uruchamiasz kilka serwerów na jednej maszynie (np. 25566, 25567). Pamiętaj o aktualizacji port forwardingu na routerze.

max-players Maksymalna liczba jednoczesnych graczy. Domyślnie 20. Na każdego gracza licz ~100-200 MB RAM przy standardowej rozgrywce. 50 graczy z pluginami to minimum 8 GB RAM dla serwera.

gamemode Domyślny tryb gry dla nowych graczy: survival, creative, adventure, spectator. Gracze z permisją mogą go zmieniać komendą /gamemode.

difficulty Poziom trudności: peaceful (bez wrogów), easy, normal (zalecany), hard. Wpływa na obrażenia od mobów, tempo głodu i zachowanie niektórych mechanik (np. zombie łamią drzwi na hard).

pvp Od wersji 1.21.9 tej opcji nie ma w server.properties. Zastąpiła ją reguła gry pvp (w 1.21.9 i 1.21.10 pod tą samą nazwą), którą ustawisz komendą /gamerule. Decyduje, czy gracze mogą zadawać sobie obrażenia, domyślnie true. Na serwerach Survival z pluginem GriefPrevention lepiej zostawić true i kontrolować PvP przez regiony.

allow-flight true lub false. Domyślnie false, co oznacza, że serwer wyrzuca graczy wykrytych jako latających (bez elytr). Jeśli używasz pluginów dających latanie (np. EssentialsX /fly), ustaw na true. Nie jest to anti-cheat, tylko podstawowa detekcja.

enable-command-block Od wersji 1.21.9 tej opcji nie ma w server.properties. Zastąpiła ją reguła gry command_blocks_work (w 1.21.9 i 1.21.10 pod nazwą commandBlocksEnabled), którą ustawisz komendą /gamerule. Decyduje, czy działają bloki komend, domyślnie true. Przydają się do minigier i automatyzacji bez pluginów. Na serwerach publicznych lepiej je wyłączyć i korzystać z pluginów.

force-gamemode true lub false. Jeśli true, gracze przy każdym dołączeniu zostaną ustawieni na domyślny tryb gry. Przydatne na serwerach adventure/minigames.

Ustawienia świata i generowania

Te opcje dotyczą generowania terenu, typu świata i spawnu.

level-name Nazwa folderu ze światem. Domyślnie world. Zmień, żeby użyć innego świata bez usuwania obecnego. Folder o podanej nazwie musi istnieć w katalogu serwera lub zostanie wygenerowany nowy świat.

level-seed Seed generatora świata. Zostaw puste dla losowego. Wpisz konkretną wartość (liczbę lub tekst), jeśli chcesz konkretny układ terenu. Seed nie zmieni już wygenerowanych chunków. Fajne seedy do testowania znajdziesz na naszej stronie o biomach.

level-type Typ generatora świata: minecraft\:normal (standardowy), minecraft\:flat (płaski), minecraft\:large_biomes (duże biomy), minecraft\:amplified (ekstremalny teren, wymaga mocnego CPU), minecraft\:single_biome_surface (jeden biom).

generate-structures true lub false. Czy generować struktury (wiosek, fortec, spawnerów itp.). Na serwerze Creative możesz wyłączyć. Na Survival zdecydowanie zostaw true.

max-world-size Maksymalny promień świata w blokach od punktu 0,0. Domyślnie 29999984. Zmniejszenie do np. 10000 ogranicza rozmiar świata i oszczędza miejsce na dysku. Na mniejszych serwerach rozważ ustawienie granicy świata przez World Border.

spawn-protection Promień ochrony spawnu w blokach. Domyślnie 16. Tylko operatorzy (OP) mogą modyfikować bloki w tym zasięgu. Ustaw na 0, żeby wyłączyć. Na serwerach z pluginem WorldGuard lepiej ustawić 0 i kontrolować spawn regionami.

spawn-npcs Opcja usunięta w wersji 1.21.2. Decydowała, czy mogą spawnować się wieśniacy (NPC), a nie o generowaniu wiosek. Na serwerze 1.21.2 lub nowszym tego ustawienia już nie ma.

spawn-monsters Od wersji 1.21.9 tej opcji nie ma w server.properties. Zastąpiła ją reguła gry spawn_monsters (w 1.21.9 i 1.21.10 pod nazwą spawnMonsters), którą ustawisz komendą /gamerule. Decyduje, czy wrogie moby spawnują się naturalnie.

spawn-animals Opcja usunięta w wersji 1.21.2. Decydowała, czy mogą spawnować się zwierzęta. Na serwerze 1.21.2 lub nowszym tego ustawienia już nie ma.

allow-nether Od wersji 1.21.9 tej opcji nie ma w server.properties. Zastąpiła ją reguła gry allow_entering_nether_using_portals (w 1.21.9 i 1.21.10 pod nazwą allowEnteringNetherUsingPortals), którą ustawisz komendą /gamerule. Decyduje, czy do Netheru można wejść przez portal, domyślnie true. Wyłącz ją, jeśli chcesz ograniczyć rozgrywkę do Overworldu (np. na serwerze Creative).

Ustawienia wydajności

Te opcje mają bezpośredni wpływ na płynność serwera. Dostrojenie ich to pierwszy krok przed sięgnięciem po pluginy optymalizacyjne. Więcej o zaawansowanej optymalizacji znajdziesz w poradniku o optymalizacji serwera.

view-distance Zasięg renderowania chunków widocznych dla gracza (domyślnie 10). Każdy chunk to 16x16 bloków. Zmniejszenie do 6-8 znacząco poprawia wydajność, szczególnie przy większej liczbie graczy. Wartość 10 to ok. 441 chunków na gracza, wartość 6 to 169.

simulation-distance Zasięg symulacji chunków (domyślnie 10). Chunki poza tym zasięgiem są "zamrożone" - farmy, redstone, moby nie działają. Zmniejsz do 4-6 na obciążonych serwerach. To jedno z najskuteczniejszych ustawień wydajnościowych.

max-tick-time Maksymalny czas jednego ticku serwera w milisekundach (domyślnie 60000). Jeśli tick trwa dłużej, serwer uznaje crash i się wyłącza. Ustaw na -1, żeby wyłączyć watchdog. Przydatne przy dużych operacjach WorldEdit, ale nie zalecane na produkcji.

network-compression-threshold Próg kompresji pakietów sieciowych w bajtach (domyślnie 256). Pakiety mniejsze niż ta wartość nie są kompresowane. Zmniejszenie do 64 może pomóc na łączach o niskim uploadzie, ale zwiększa obciążenie CPU.

max-chained-neighbor-updates Limit kaskadowych aktualizacji sąsiadów (domyślnie 1000000). Ogranicza lagi spowodowane dużymi maszynami redstonowymi. Zmniejszenie do 10000 zapobiega zamrażaniu serwera przez skomplikowane obwody.

entity-broadcast-range-percentage Procent zasięgu wysyłania informacji o entity do klientów (domyślnie 100). Zmniejszenie do 50-75 redukuje ruch sieciowy. Gracze zobaczą entity z mniejszej odległości, ale serwer będzie mniej obciążony.

Zalecana konfiguracja dla 20-30 graczy: view-distance=8, simulation-distance=5, entity-broadcast-range-percentage=75. To dobry balans między wydajnością a komfortem gry. Jeśli używasz Papera, masz dodatkowe opcje optymalizacji w plikach paper-world-defaults.yml i paper-global.yml.

Sieć i bezpieczeństwo

Te ustawienia kontrolują, kto może dołączyć do serwera i jak działa połączenie sieciowe. Więcej o zabezpieczeniach znajdziesz w poradniku o ochronie serwera.

online-mode true lub false. Czy serwer weryfikuje konta graczy przez serwery Mojang. Zawsze zostawiaj true na publicznych serwerach. Ustawienie false pozwala na dołączanie piratów i otwiera drzwi na spoofing (podszywanie się pod innych graczy). Jedyny wyjątek: serwery za proxy Velocity/BungeeCord, gdzie weryfikacja odbywa się na proxy.

white-list true lub false, od wersji 26.3 domyślnie true (wcześniej false). Włącza białą listę. Tylko gracze dodani komendą /whitelist add Gracz mogą dołączyć. Sprawdza się na prywatnych serwerach. Na serwerze publicznym ustaw false. Zarządzaj listą bez restartu: /whitelist reload.

enforce-whitelist true lub false. Jeśli true, gracze usunięci z whitelisty zostaną natychmiast wyrzuceni z serwera (nie tylko przy kolejnym dołączeniu).

server-ip Adres IP, na którym nasłuchuje serwer. Zostaw puste (domyślne), żeby nasłuchiwać na wszystkich interfejsach. Ustaw konkretny IP tylko wtedy, gdy maszyna ma kilka kart sieciowych i chcesz ograniczyć dostęp.

prevent-proxy-connections true lub false. Blokuje połączenia przez proxy/VPN. Może pomóc w walce z ban evasion, ale też zablokuje graczy legalnie korzystających z VPN.

rate-limit Limit pakietów na sekundę od jednego gracza (domyślnie 0 = wyłączony). Ustawienie na 10-15 może pomóc przy atakach spamujących, ale za niska wartość wyrzuci normalnych graczy.

enable-rcon true lub false. Włącza RCON (Remote Console) do zdalnego zarządzania serwerem. Wymaga ustawienia rcon.password i rcon.port. Użyteczne do automatyzacji i paneli administracyjnych.

enable-query true lub false. Włącza protokół query (domyślnie port 25565 UDP). Pozwala zewnętrznym narzędziom (np. listom serwerów) na pobieranie informacji o serwerze.

Uwaga: Nigdy nie ustawiaj online-mode=false na publicznym serwerze bez pluginu uwierzytelniającego (np. AuthMe). Bez weryfikacji każdy może dołączyć z dowolnym nickiem, włącznie z nickami administratorów, i przejąć kontrolę nad serwerem.

Opcje zaawansowane

Rzadziej zmieniane ustawienia, które mogą się przydać w specyficznych scenariuszach.

resource-pack URL do paczki zasobów (resource pack) w formacie ZIP. Serwer sugeruje graczom pobranie tej paczki przy dołączeniu. Plik musi być hostowany na publicznym serwerze HTTP (np. Dropbox, GitHub Releases, własny CDN).

resource-pack-sha1 Hash SHA-1 paczki zasobów. Klient porównuje hash i pobiera paczkę ponownie tylko wtedy, gdy się zmienił. Wygeneruj hash komendą sha1sum paczka.zip na Linuksie lub narzędziem online.

require-resource-pack true lub false. Jeśli true, gracze odmawiający pobrania paczki zasobów zostaną rozłączeni. Przydatne na serwerach RPG z własnymi teksturami.

player-idle-timeout Czas bezczynności w minutach, po którym gracz zostaje wyrzucony. Domyślnie 0 (wyłączony). Ustaw na 15-30, żeby zwalniać sloty dla aktywnych graczy. Gracze AFK na farmach mogą być niezadowoleni, więc komunikuj tę zasadę jasno.

op-permission-level Poziom uprawnień operatora (1-4). Domyślnie 4. Poziom 1: omijanie spawn protection. Poziom 2: komendy typu /gamemode i /give. Poziom 3: komendy administracyjne (/ban, /kick). Poziom 4: pełna kontrola (/stop, /save-all). Na serwerach z LuckPerms lepiej nie dawać OP wcale i zarządzać permisjami przez plugin uprawnień.

function-permission-level Poziom uprawnień wymagany do uruchamiania data packów (domyślnie 2). Zmień tylko wtedy, gdy korzystasz z data packów wymagających wyższych uprawnień.

enable-status true lub false. Czy serwer odpowiada na zapytania statusu (ping z listy serwerów). Wyłączenie sprawia, że serwer nie pojawia się na listach, ale nadal można się połączyć, znając adres.

log-ips true lub false (od 1.20.2, domyślnie true). Decyduje, czy adresy IP graczy pojawiają się w komunikatach w konsoli serwera i w pliku logu.

Gotowe konfiguracje na start

Zamiast konfigurować wszystko od zera, oto trzy sprawdzone konfiguracje dla różnych typów serwerów. Skopiuj odpowiednią i dostosuj do swoich potrzeb.

Serwer Survival dla znajomych (5-10 graczy)

 motd=\u00a7aSerwer survival \u00a77- \u00a7fDolacz!
gamemode=survival
difficulty=normal
max-players=10
view-distance=10
simulation-distance=8
online-mode=true
white-list=true
spawn-protection=0
allow-flight=false 

Mały, prywatny serwer. Whitelist chroni przed nieproszonymi gośćmi, a brak spawn protection daje graczom pełną swobodę budowania od spawnu.

Serwer publiczny z pluginami (20-50 graczy)

 motd=\u00a76\u00a7lMojSerwer.pl \u00a77| \u00a7fSurvival \u00a7a1.21.4
gamemode=survival
difficulty=hard
max-players=50
view-distance=8
simulation-distance=5
online-mode=true
white-list=false
spawn-protection=0
allow-flight=true
player-idle-timeout=30
entity-broadcast-range-percentage=75
network-compression-threshold=128 

Zoptymalizowany pod wydajność przy większej liczbie graczy. allow-flight=true, bo pluginy typu EssentialsX dają latanie. Spawn protection wyłączony, bo regiony ogarnia WorldGuard. white-list=false trzeba wpisać ręcznie, bo od wersji 26.3 biała lista jest domyślnie włączona.

Serwer Creative / budowlany (10-20 graczy)

 motd=\u00a7b\u00a7lCreative Build Server
gamemode=creative
difficulty=peaceful
max-players=20
view-distance=12
simulation-distance=6
online-mode=true
white-list=true
spawn-protection=0
allow-flight=true
generate-structures=false
level-type=minecraft\:flat 

Płaski świat bez wrogich mobów (difficulty=peaceful). Wyższy view-distance, żeby gracze widzieli więcej budowli. PvP i bloki komend to od wersji 1.21.9 reguły gry, a nie opcje tego pliku: bloki komend działają domyślnie, a PvP wyłączysz komendą /gamerule pvp false.

Najczęściej zadawane pytania

Czy mogę edytować server.properties gdy serwer jest włączony?

Możesz zapisać plik, ale zmiany w server.properties zadziałają dopiero po restarcie serwera. Część ustawień zmienisz bez restartu komendami. Poziom trudności ustawisz komendą /difficulty, ale tylko do restartu, bo przy starcie serwer znów wczytuje difficulty z pliku. PvP, bloki komend i wejście do Netheru to od wersji 1.21.9 reguły gry, które zmienisz komendą /gamerule (np. /gamerule pvp false). Reguły gry zapisują się w danych świata, więc przetrwają restart.

Usunąłem server.properties. Co teraz?

Serwer wygeneruje nowy plik z domyślnymi wartościami przy następnym uruchomieniu. Stracisz swoją konfigurację, ale serwer będzie działał. Dlatego warto robić kopie zapasowe.

Moje zmiany nie działają po restarcie?

Sprawdź, czy edytujesz właściwy plik (w katalogu serwera, nie w katalogu świata). Upewnij się, że nie masz literówek w nazwach opcji i że po znaku = nie ma spacji. Opcje z błędnym kluczem są po cichu ignorowane.

Gdzie znajdę dodatkowe opcje dla Papera?

Paper ma własne pliki konfiguracyjne: paper-global.yml, paper-world-defaults.yml i config/paper-world.yml per świat. Oferują one dziesiątki dodatkowych opcji optymalizacyjnych niedostępnych w standardowym server.properties.

Co dalej?

Masz skonfigurowany plik server.properties. Czas na kolejne kroki:

Zabezpiecz serwer przed griefingiem, cheaterami i atakami.
Skonfiguruj rangi i uprawnienia za pomocą LuckPerms.
Zarządzaj światami za pomocą Multiverse i World Border.
Zoptymalizuj wydajność za pomocą Papera i zaawansowanych ustawień.
Zainstaluj pluginy, które rozszerzą możliwości serwera.
Postaw serwer Bedrock - Bedrock Dedicated Server ma własny plik server.properties z innymi kluczami i portem 19132.
Skonfiguruj kopie zapasowe, żeby nie stracić postępów.