Discord
Wiki - Serwery

Konfiguracja server.properties

Pelny opis kazdej opcji w pliku server.properties. Dowiedz sie, co robi kazde ustawienie i jak dostosowac serwer do swoich potrzeb.

Czas czytania: ~15 min Poziom: Poczatkujacy / Sredniozaawansowany

Czym jest server.properties?

Plik server.properties to glowny plik konfiguracyjny serwera Minecraft Java Edition. Generuje sie automatycznie przy pierwszym uruchomieniu serwera i znajduje sie w katalogu glownym serwera, obok pliku server.jar. Kazda linia zawiera jedna opcje w formacie klucz=wartosc.

Edytujesz go zwyklym edytorem tekstu (Notepad++, VS Code, nano). Po kazdej zmianie musisz zrestartowac serwer, zeby nowe ustawienia zostaly zastosowane. Linie zaczynajace sie od # to komentarze i serwer je ignoruje.

Wskazowka: Zanim zaczniesz modyfikowac plik, zrob kopie zapasowa. Wystarczy skopiowac server.properties i nazwac kopie np. server.properties.bak. Jesli cos popssujesz, masz do czego wrocic.

Jesli nie masz jeszcze serwera, przejdz najpierw do naszego poradnika jak zalozyc serwer Minecraft, gdzie krok po kroku przeprowadzimy Cie przez caly proces.

Podstawowe ustawienia serwera

Te opcje kontroluja fundamentalne zachowanie serwera. Od nich zacznij konfiguracje.

motd Wiadomosc widoczna na liscie serwerow w kliencie gry (Message of the Day). Obsluguje kody kolorow z prefiksem \u00a7 (np. \u00a76Moj Serwer = zloty tekst). Maksymalnie 59 znakow. Uzyj generatora MOTD online, zeby latwo tworzyc kolorowe opisy z formatowaniem.
server-port Port, na ktorym nasluchuje serwer. Domyslnie 25565. Zmien tylko wtedy, gdy uruchamiasz kilka serwerow na jednej maszynie (np. 25566, 25567). Pamietaj o aktualizacji port forwardingu na routerze.
max-players Maksymalna liczba jednoczesnych graczy. Domyslnie 20. Na kazdego gracza licz ~100-200 MB RAM przy standardowej rozgrywce. 50 graczy z pluginami to minimum 8 GB RAM dla serwera.
gamemode Domyslny tryb gry dla nowych graczy: survival, creative, adventure, spectator. Gracze z permisja moga go zmieniac komenda /gamemode.
difficulty Poziom trudnosci: peaceful (bez wrogow), easy, normal (zalecany), hard. Wplywa na obrazenia od mobow, tempo glodu i zachowanie niektorych mechanik (np. zombie lamia drzwi na hard).
pvp true lub false. Wlacza lub wylacza mozliwosc atakowania innych graczy. Na serwerach Survival z pluginem GriefPrevention lepiej zostawic true i kontrolowac PvP przez regiony.
allow-flight true lub false. Domyslnie false, co oznacza, ze serwer wyrzuca graczy wykrytych jako latajacych (bez elytr). Jesli uzywasz pluginow dajacych latanie (np. EssentialsX /fly), ustaw na true. Nie jest to anti-cheat, tylko podstawowa detekcja.
enable-command-block true lub false. Wlacza bloki komend. Przydatne do minigier i automatyzacji bez pluginow. Na serwerach publicznych lepiej wylaczyc i korzystac z pluginow.
force-gamemode true lub false. Jesli true, gracze przy kazdym dolaczeniu zostana ustawieni na domyslny tryb gry. Przydatne na serwerach adventure/minigames.

Ustawienia swiata i generowania

Te opcje kontroluja generowanie terenu, typ swiata i spawna.

level-name Nazwa folderu ze swiatem. Domyslnie world. Zmien, zeby uzyc innego swiata bez usuwania obecnego. Folder o podanej nazwie musi istniec w katalogu serwera lub zostanie wygenerowany nowy swiat.
level-seed Seed generatora swiata. Zostaw puste dla losowego. Wpisz konkretna wartosc (liczbe lub tekst), jesli chcesz konkretny uklad terenu. Seed nie zmieni juz wygenerowanych chunkow. Fajne seedy do testowania znajdziesz na naszej stronie o biomach.
level-type Typ generatora swiata: minecraft\:normal (standardowy), minecraft\:flat (plaski), minecraft\:large_biomes (duze biomy), minecraft\:amplified (ekstremalny teren, wymaga mocnego CPU), minecraft\:single_biome_surface (jeden biom).
generate-structures true lub false. Czy generowac struktury (wiosek, fortecy, spawnerow itp.). Na serwerze Creative mozesz wylaczyc. Na Survival zdecydowanie zostaw true.
max-world-size Maksymalny promien swiata w blokach od punktu 0,0. Domyslnie 29999984. Zmniejszenie do np. 10000 ogranicza rozmiar swiata i oszczedza miejsce na dysku. Na mniejszych serwerach rozważ ustawienie granicy swiata przez World Border.
spawn-protection Promien ochrony spawnu w blokach. Domyslnie 16. Tylko operatorzy (OP) moga modyfikowac bloki w tym zasiegu. Ustaw na 0, zeby wylaczyc. Na serwerach z pluginem WorldGuard lepiej ustawic 0 i kontrolowac spawn regionami.
spawn-npcs true lub false. Czy spawnuja sie wiesnicy (NPC). Wylaczenie moze pomoc wydajnosci na bardzo duzych serwerach, ale usunie wioski.
spawn-monsters true lub false. Czy spawnuja sie wrogie moby. Ustawienie na false dziala jak difficulty=peaceful, ale nie wplywa na glod.
spawn-animals true lub false. Czy spawnuja sie zwierzeta. Wylaczenie moze pomoc na serwerach, gdzie zwierzeta nie sa potrzebne (np. Skyblock).
allow-nether true lub false. Wlacza lub wylacza dostep do Netheru. Wylacz, jesli chcesz ograniczyc rozgrywke do Overworldu (np. na serwerze Creative).

Ustawienia wydajnosci

Te opcje maja bezposredni wplyw na plynnosc serwera. Dostrojenie ich to pierwszy krok przed siegnieciem po pluginy optymalizacyjne. Wiecej o zaawansowanej optymalizacji znajdziesz w poradniku o optymalizacji serwera.

view-distance Zasieg renderowania chunkow widocznych dla gracza (domyslnie 10). Kazdy chunk to 16x16 blokow. Zmniejszenie do 6-8 znaczaco poprawia wydajnosc, szczegolnie przy wiekszej liczbie graczy. Wartosc 10 to ok. 441 chunkow na gracza, wartosc 6 to 169.
simulation-distance Zasieg symulacji chunkow (domyslnie 10). Chunki poza tym zasiegiem sa "zamrozone" - farmy, redstonee, moby nie dzialaja. Zmniejsz do 4-6 na obciazonych serwerach. To jedno z najskuteczniejszych ustawien wydajnosciowych.
max-tick-time Maksymalny czas jednego ticku serwera w milisekundach (domyslnie 60000). Jesli tick trwa dluzej, serwer uznaje crash i sie wylacza. Ustaw na -1, zeby wylaczyc watchdog. Przydatne przy duzych operacjach WorldEdit, ale nie zalecane na produkcji.
network-compression-threshold Prog kompresji pakietow sieciowych w bajtach (domyslnie 256). Pakiety mniejsze niz ta wartosc nie sa kompresowane. Zmniejszenie do 64 moze pomoc na laczach o niskim uploadzie, ale zwieksza obciazenie CPU.
max-chained-neighbor-updates Limit kaskadowych aktualizacji sasiadow (domyslnie 1000000). Ogranicza lagi spowodowane duzymi maszynami redstonowymi. Zmniejszenie do 10000 zapobiega zamrazaniu serwera przez skomplikowane obwody.
entity-broadcast-range-percentage Procent zasiegu wysylania informacji o entity do klientow (domyslnie 100). Zmniejszenie do 50-75 redukuje ruch sieciowy. Gracze zobacza entity z mniejszej odleglosci, ale serwer bedzie mniej obciazony.

Zalecana konfiguracja dla 20-30 graczy: view-distance=8, simulation-distance=5, entity-broadcast-range-percentage=75. To dobry balans miedzy wydajnoscia a komfortem gry. Jesli uzywasz Papera, masz dodatkowe opcje optymalizacji w plikach paper-world-defaults.yml i paper-global.yml.

Siec i bezpieczenstwo

Te ustawienia kontroluja, kto moze dolaczyc do serwera i jak dziala polaczenie sieciowe. Wiecej 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 dolaczanie piratow i otwiera drzwi na spoofing (podszywanie sie pod innych graczy). Jedyny wyjątek: serwery za proxy Velocity/BungeeCord, gdzie weryfikacja odbywa sie na proxy.
white-list true lub false. Wlacza biala liste. Tylko gracze dodani komenda /whitelist add Gracz moga dolaczyc. Idealne dla prywatnych serwerow. Zarzadzaj lista bez restartu: /whitelist reload.
enforce-whitelist true lub false. Jesli true, gracze usunieci z whitelisty zostana natychmiast wyrzuceni z serwera (nie tylko przy kolejnym dolaczeniu).
server-ip Adres IP, na ktorym nasluchuje serwer. Zostaw puste (domyslne), zeby nasluchiwac na wszystkich interfejsach. Ustaw konkretny IP tylko jesli maszyna ma kilka kart sieciowych i chcesz ograniczyc dostep.
prevent-proxy-connections true lub false. Blokuje polaczenia przez proxy/VPN. Moze pomoc w walce z ban evasion, ale tez zablokuje graczy legalnie korzystajacych z VPN.
rate-limit Limit pakietow na sekunde od jednego gracza (domyslnie 0 = wylaczony). Ustawienie na 10-15 moze pomoc przy atakach spamujacych, ale za niska wartosc wyrzuci normalnych graczy.
enable-rcon true lub false. Wlacza RCON (Remote Console) do zdalnego zarzadzania serwerem. Wymaga ustawienia rcon.password i rcon.port. Uzyteczne do automatyzacji i paneli administracyjnych.
enable-query true lub false. Wlacza protokol query (domyslnie port 25565 UDP). Pozwala zewnetrznym narzediom (np. listom serwerow) na pobieranie informacji o serwerze.

Uwaga: Nigdy nie ustawiaj online-mode=false na publicznym serwerze bez pluginu uwierzytelniajacego (np. AuthMe). Bez weryfikacji kazdy moze dolaczyc z dowolnym nickiem, wlacznie z nickami administratorow, i przejac kontrole nad serwerem.

Opcje zaawansowane

Rzadziej zmieniane ustawienia, ktore moga sie przydac w specyficznych scenariuszach.

resource-pack URL do paczki zasobow (resource pack) w formacie ZIP. Serwer sugeruje graczom pobranie tej paczki przy dolaczeniu. Plik musi byc hostowany na publicznym serwerze HTTP (np. Dropbox, GitHub Releases, wlasny CDN).
resource-pack-sha1 Hash SHA-1 paczki zasobow. Klient porownuje hash i pobiera paczke ponownie tylko jesli sie zmienil. Wygeneruj hash komenda sha1sum paczka.zip na Linux lub narzedziem online.
require-resource-pack true lub false. Jesli true, gracze odmawiajacy pobrania paczki zasobow zostana rozlaczeni. Przydatne na serwerach RPG z customowymi teksturami.
player-idle-timeout Czas bezczynnosci w minutach, po ktorym gracz zostaje wyrzucony. Domyslnie 0 (wylaczony). Ustaw na 15-30, zeby zwalniac sloty dla aktywnych graczy. Gracze AFK na farmach moga byc niezadowoleni, wiec komunikuj te zasade jasno.
op-permission-level Poziom uprawnien operatora (1-4). Domyslnie 4. Poziom 1: omijanie spawn protection. Poziom 2: komendy cheats. Poziom 3: komendy administracyjne (/ban, /kick). Poziom 4: pelna kontrola (/stop, /save-all). Na serwerach z LuckPerms lepiej nie dawac OP wcale i zarzadzac permsjami przez plugin uprawnien.
function-permission-level Poziom uprawnien wymagany do uruchamiania data packow (domyslnie 2). Zmien tylko jesli korzystasz z data packow wymagajacych wyzszych uprawnien.
enable-status true lub false. Czy serwer odpowiada na zapytania statusu (ping z listy serwerow). Wylaczenie sprawia, ze serwer nie pojawia sie na listach, ale nadal mozna sie polaczyc znajac adres.
log-ips true lub false (od 1.20.2). Czy logowac adresy IP graczy. Wymagane przez RODO/GDPR, jesli prowadzisz serwer w UE. Rozważ ustawienie na false i logowanie tylko przez pluginy, ktore obsluguja anonimizacje.

Gotowe konfiguracje na start

Zamiast konfigurowac wszystko od zera, oto trzy sprawdzone konfiguracje dla roznych typow serwerow. Skopiuj odpowiednia i dostosuj do swoich potrzeb.

Serwer Survival dla znajomych (5-10 graczy)

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

Maly, prywatny serwer. Whitelist chroni przed nieprosonymi goscmi, a brak spawn protection daje graczom pelna swobode budowania od spawnu.

Serwer publiczny z pluginami (20-50 graczy)

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

Zoptymalizowany pod wydajnosc przy wiekszej liczbie graczy. allow-flight=true bo pluginy typu EssentialsX daja latanie. Spawn protection wylaczony, bo regiony ogarnia WorldGuard.

Serwer Creative / budowlany (10-20 graczy)

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

Plaski swiat bez mobow. Idealny do budowania. Bloki komend wlaczone dla automatyzacji. Wyzszy view-distance, zeby gracze widzieli wiecej budowli.

Najczesciej zadawane pytania

Czy moge edytowac server.properties gdy serwer jest wlaczony?

Mozesz zapisac plik, ale zmiany nie wejda w zycie bez restartu serwera. Niektore opcje (np. difficulty, pvp) mozna zmieniac na zywo komendami /difficulty i bez edycji pliku, ale te zmiany nie przetrwaja restartu, jesli plik nie zostanie zaktualizowany.

Usunelem server.properties. Co teraz?

Serwer wygeneruje nowy plik z domyslnymi wartosciami przy nastepnym uruchomieniu. Stracisz swoja konfiguracje, ale serwer bedzie dzialal. Dlatego warto robic kopie zapasowe.

Moje zmiany nie dzialaja po restarcie?

Sprawdz, czy edytujesz wlasciwy plik (w katalogu serwera, nie w katalogu swiata). Upewnij sie, ze nie masz literowek w nazwach opcji i ze po znaku = nie ma spacji. Opcje z blednym kluczem sa po cichu ignorowane.

Gdzie znajde dodatkowe opcje dla Papera?

Paper ma wlasne pliki konfiguracyjne: paper-global.yml, paper-world-defaults.yml i config/paper-world.yml per swiat. Oferuja one dziesiatki dodatkowych opcji optymalizacyjnych niedostepnych w standardowym server.properties.

Co dalej?

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

Komentarze