Discord
Wiki - Serwery

Konfiguracja server.properties

Pełny opis każdej opcji w pliku server.properties. Dowiedz się, co robi każde ustawienie i jak dostosowac serwer do swoich potrzeb.

Czas czytania: ~15 min Poziom: Poczatkujacy / Średniozaawansowany

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 jedna opcje w formacie klucz=wartość.

Edytujesz go zwyklym edytorem tekstu (Notepad++, VS Code, nano). Po każdej zmianie musisz zrestartować serwer, zeby nowe ustawienia zostaly zastosowane. Linie zaczynajace się od # to komentarze i serwer je ignoruje.

Wskazówka: Zanim zaczniesz modyfikowac plik, zrob kopie zapasowa. Wystarczy skopiowac server.properties i nazwac kopie np. server.properties.bak. Jeśli cos popssujesz, masz do czego wrocic.

Jeśli nie masz jeszcze serwera, przejdz najpierw do naszego poradnika jak założyć serwer Minecraft, gdzie krok po kroku przeprowadzimy Cie przez cały 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 kolorów z prefiksem \u00a7 (np. \u00a76Moj Serwer = złoty tekst). Maksymalnie 59 znakow. Uzyj generatora MOTD online, zeby łatwo tworzyć kolorowe opisy z formatowaniem.
server-port Port, na którym 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 każdego 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 mogą go zmieniac komenda /gamemode.
difficulty Poziom trudności: peaceful (bez wrogow), easy, normal (zalecany), hard. Wpływa na obrażenia od mobow, tempo glodu i zachowanie niektórych mechanik (np. zombie lamia drzwi na hard).
pvp true lub false. Włącza lub wyłącza możliwość 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 latających (bez elytr). Jeśli uzywasz pluginow dających latanie (np. EssentialsX /fly), ustaw na true. Nie jest to anti-cheat, tylko podstawowa detekcja.
enable-command-block true lub false. Włącza bloki komend. Przydatne do minigier i automatyzacji bez pluginow. Na serwerach publicznych lepiej wyłączyć i korzystac z pluginow.
force-gamemode true lub false. Jeśli true, gracze przy każdym dolaczeniu zostana ustawieni na domyslny tryb gry. Przydatne na serwerach adventure/minigames.

Ustawienia świata i generowania

Te opcje kontroluja generowanie terenu, typ świata i spawna.

level-name Nazwa folderu ze światem. Domyslnie world. Zmien, zeby użyć innego świata bez usuwania obecnego. Folder o podanej nazwie musi istniec w katalogu serwera lub zostanie wygenerowany nowy świat.
level-seed Seed generatora świata. Zostaw puste dla losowego. Wpisz konkretna wartość (liczbe lub tekst), jeśli chcesz konkretny uklad terenu. Seed nie zmieni juz wygenerowanych chunkow. Fajne seedy do testowania znajdziesz na naszej stronie o biomach.
level-type Typ generatora świata: minecraft\:normal (standardowy), minecraft\:flat (plaski), 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 generowac struktury (wiosek, fortecy, spawnerow itp.). Na serwerze Creative możesz wyłączyć. Na Survival zdecydowanie zostaw true.
max-world-size Maksymalny promien świata w blokach od punktu 0,0. Domyslnie 29999984. Zmniejszenie do np. 10000 ogranicza rozmiar świata i oszczedza miejsce na dysku. Na mniejszych serwerach rozważ ustawienie granicy świata przez World Border.
spawn-protection Promien ochrony spawnu w blokach. Domyslnie 16. Tylko operatorzy (OP) mogą modyfikowac bloki w tym zasięgu. Ustaw na 0, zeby wyłączyć. Na serwerach z pluginem WorldGuard lepiej ustawić 0 i kontrolowac spawn regionami.
spawn-npcs true lub false. Czy spawnuja się wiesnicy (NPC). Wyłączenie może pomóc wydajności na bardzo dużych serwerach, ale usunie wioski.
spawn-monsters true lub false. Czy spawnuja się wrogie moby. Ustawienie na false działa jak difficulty=peaceful, ale nie wpływa na glod.
spawn-animals true lub false. Czy spawnuja się zwierzęta. Wyłączenie może pomóc na serwerach, gdzie zwierzęta nie sa potrzebne (np. Skyblock).
allow-nether true lub false. Włącza lub wyłącza dostep do Netheru. Wyłącz, jeśli chcesz ograniczyc rozgrywke do Overworldu (np. na serwerze Creative).

Ustawienia wydajności

Te opcje mają bezpośredni wpływ na plynnosc serwera. Dostrojenie ich to pierwszy krok przed siegnieciem po pluginy optymalizacyjne. Więcej o zaawansowanej optymalizacji znajdziesz w poradniku o optymalizacji serwera.

view-distance Zasięg renderowania chunkow widocznych dla gracza (domyslnie 10). Każdy chunk to 16x16 bloków. Zmniejszenie do 6-8 znacząco poprawia wydajność, szczególnie przy wiekszej liczbie graczy. Wartość 10 to ok. 441 chunkow na gracza, wartość 6 to 169.
simulation-distance Zasięg symulacji chunkow (domyslnie 10). Chunki poza tym zasięgiem sa "zamrozone" - farmy, redstonee, moby nie działają. 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). Jeśli tick trwa dłużej, serwer uznaje crash i się wyłącza. Ustaw na -1, zeby wyłączyć watchdog. Przydatne przy dużych operacjach WorldEdit, ale nie zalecane na produkcji.
network-compression-threshold Prog kompresji pakietow sieciowych w bajtach (domyslnie 256). Pakiety mniejsze niz ta wartość nie sa kompresowane. Zmniejszenie do 64 może pomóc na łącząch o niskim uploadzie, ale zwieksza obciazenie CPU.
max-chained-neighbor-updates Limit kaskadowych aktualizacji sąsiadow (domyslnie 1000000). Ogranicza lagi spowodowane duzymi maszynami redstonowymi. Zmniejszenie do 10000 zapobiega zamrazaniu serwera przez skomplikowane obwody.
entity-broadcast-range-percentage Procent zasięgu 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 między wydajnoscia a komfortem gry. Jeśli uzywasz Papera, masz dodatkowe opcje optymalizacji w plikach paper-world-defaults.yml i paper-global.yml.

Siec i bezpieczeństwo

Te ustawienia kontroluja, kto może dolaczyc 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 dolaczanie piratow 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. Włącza biała listę. Tylko gracze dodani komenda /whitelist add Gracz mogą dolaczyc. Idealne dla prywatnych serwerow. Zarzadzaj lista bez restartu: /whitelist reload.
enforce-whitelist true lub false. Jeśli true, gracze usunieci z whitelisty zostana natychmiast wyrzuceni z serwera (nie tylko przy kolejnym dolaczeniu).
server-ip Adres IP, na którym nasluchuje serwer. Zostaw puste (domyslne), zeby nasluchiwac na wszystkich interfejsach. Ustaw konkretny IP tylko jeśli maszyna ma kilka kart sieciowych i chcesz ograniczyc dostep.
prevent-proxy-connections true lub false. Blokuje połączenia przez proxy/VPN. Może pomóc w walce z ban evasion, ale tez zablokuje graczy legalnie korzystających z VPN.
rate-limit Limit pakietow na sekunde od jednego gracza (domyslnie 0 = wyłączony). Ustawienie na 10-15 może pomóc przy atakach spamujacych, ale za niska wartość wyrzuci normalnych graczy.
enable-rcon true lub false. Włącza 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. Włącza 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 każdy może dolaczyc z dowolnym nickiem, włącznie z nickami administratorow, i przejac kontrole nad serwerem.

Opcje zaawansowane

Rzadziej zmieniane ustawienia, które mogą się 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 być hostowany na publicznym serwerze HTTP (np. Dropbox, GitHub Releases, własny CDN).
resource-pack-sha1 Hash SHA-1 paczki zasobow. Klient porownuje hash i pobiera paczke ponownie tylko jeśli się zmienił. Wygeneruj hash komenda sha1sum paczka.zip na Linux lub narzedziem online.
require-resource-pack true lub false. Jeśli true, gracze odmawiajacy pobrania paczki zasobow zostana rozlaczeni. Przydatne na serwerach RPG z customowymi teksturami.
player-idle-timeout Czas bezczynnosci w minutach, po którym gracz zostaje wyrzucony. Domyslnie 0 (wyłączony). Ustaw na 15-30, zeby zwalniac sloty dla aktywnych graczy. Gracze AFK na farmach mogą być 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: pełna 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 jeśli korzystasz z data packow wymagających wyższych uprawnien.
enable-status true lub false. Czy serwer odpowiada na zapytania statusu (ping z listy serwerow). Wyłączenie sprawia, ze serwer nie pojawia się na listach, ale nadal można się połączyć znajac adres.
log-ips true lub false (od 1.20.2). Czy logowac adresy IP graczy. Wymagane przez RODO/GDPR, jeśli prowadzisz serwer w UE. Rozważ ustawienie na false i logowanie tylko przez pluginy, które obsluguja anonimizacje.

Gotowe konfiguracje na start

Zamiast konfigurowac wszystko od zera, oto trzy sprawdzone konfiguracje dla różnych 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

Mały, prywatny serwer. Whitelist chroni przed nieprosonymi goscmi, a brak spawn protection daje graczom pełna 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 wydajność przy wiekszej liczbie graczy. allow-flight=true bo pluginy typu EssentialsX dają latanie. Spawn protection wyłączony, 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 świat bez mobow. Idealny do budowania. Bloki komend włączone dla automatyzacji. Wyższy view-distance, zeby gracze widzieli więcej budowli.

Najczęściej zadawane pytania

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

Możesz zapisać plik, ale zmiany nie wejda w życie bez restartu serwera. Niektore opcje (np. difficulty, pvp) można zmieniac na zywo komendami /difficulty i bez edycji pliku, ale te zmiany nie przetrwaja restartu, jeśli plik nie zostanie zaktualizowany.

Usunelem server.properties. Co teraz?

Serwer wygeneruje nowy plik z domyslnymi wartościami przy następnym uruchomieniu. Stracisz swoja konfiguracje, ale serwer bedzie dzialal. Dlatego warto robic 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ę, 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 własne pliki konfiguracyjne: paper-global.yml, paper-world-defaults.yml i config/paper-world.yml per świat. Oferuja one dziesiatki dodatkowych opcji optymalizacyjnych niedostepnych w standardowym server.properties.

Co dalej?

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

Komentarze