Discord
Wiki - Serwery

Konfiguracja server.properties

Konfiguracja server.properties

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

Czas czytania: ~15 min Poziom: Początkujący / Ś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 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 kopie zapasowa. Wystarczy skopiować server.properties i nazwać kopie np. server.properties.bak. Jeśli cos popssujesz, masz do czego wrocic.

Jeśli nie masz jeszcze serwera, przejdź 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 kontrolują fundamentalne zachowanie serwera. Od nich zacznij konfiguracje.

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 znakow. 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 permisja mogą go zmieniać komenda /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 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 zostawić true i kontrolować PvP przez regiony.
allow-flight true lub false. Domyślnie false, co oznacza, ze 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 true lub false. Włącza bloki komend. Przydatne do minigier i automatyzacji bez pluginow. Na serwerach publicznych lepiej wyłączyć i korzystać z pluginow.
force-gamemode true lub false. Jeśli true, gracze przy każdym dołączeniu zostana ustawieni na domyślny tryb gry. Przydatne na serwerach adventure/minigames.

Ustawienia świata i generowania

Te opcje kontrolują generowanie terenu, typ świata i spawna.

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 konkretna wartość (liczbę lub tekst), jeśli chcesz konkretny układ terenu. Seed nie zmieni już 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 generować struktury (wiosek, fortecy, spawnerow 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 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 dostęp do Netheru. Wyłącz, 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 siegnieciem po pluginy optymalizacyjne. Więcej o zaawansowanej optymalizacji znajdziesz w poradniku o optymalizacji serwera.

view-distance Zasięg renderowania chunkow 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 chunkow na gracza, wartość 6 to 169.
simulation-distance Zasięg symulacji chunkow (domyślnie 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 ustawień wydajnosciowych.
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 sa kompresowane. Zmniejszenie do 64 może pomóc na łącząch o niskim uploadzie, ale zwiększa obciążenie CPU.
max-chained-neighbor-updates Limit kaskadowych aktualizacji sąsiadow (domyślnie 1000000). Ogranicza lagi spowodowane dużymi maszynami redstonowymi. Zmniejszenie do 10000 zapobiega zamrazaniu 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 obciazony.

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.

Siec 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. Włącza biała listę. Tylko gracze dodani komenda /whitelist add Gracz mogą dolaczyc. Idealne dla prywatnych serwerow. Zarządzaj 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 dołączeniu).
server-ip Adres IP, na którym nasłuchuje serwer. Zostaw puste (domyślne), żeby nasluchiwac na wszystkich interfejsach. Ustaw konkretny IP tylko jeśli maszyna ma kilka kart sieciowych i chcesz ograniczyć 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 pakietów na sekundę od jednego gracza (domyślnie 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 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 narzediom (np. listom serwerów) 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 dołączyć z dowolnym nickiem, włącznie z nickami administratorów, i przejąć kontrole nad serwerem.

Opcje zaawansowane

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

resource-pack URL do paczki zasobów (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 porównuje hash i pobiera paczkę ponownie tylko jeśli się zmienił. Wygeneruj hash komenda sha1sum paczka.zip na Linux lub narzędziem online.
require-resource-pack true lub false. Jeśli true, gracze odmawiajacy pobrania paczki zasobów zostana rozlaczeni. Przydatne na serwerach RPG z customowymi 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 te zasadę jasno.
op-permission-level Poziom uprawnień operatora (1-4). Domyślnie 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 dawać OP wcale i zarządzać permsjami przez plugin uprawnień.
function-permission-level Poziom uprawnień wymagany do uruchamiania data packow (domyślnie 2). Zmień 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 serwerów). Wyłączenie sprawia, ze 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). Czy logować adresy IP graczy. Wymagane przez RODO/GDPR, jeśli prowadzisz serwer w UE. Rozważ ustawienie na false i logowanie tylko przez pluginy, które obsługują anonimizacje.

Gotowe konfiguracje na start

Zamiast konfigurować wszystko od zera, oto trzy sprawdzone konfiguracje dla różnych typów 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 swobodę 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 większej 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, żeby gracze widzieli więcej budowli.

Najczęściej zadawane pytania

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

Możesz zapisać plik, ale zmiany nie wejdą w życie bez restartu serwera. Niektóre opcje (np. difficulty, pvp) można zmieniać na żywo komendami /difficulty i bez edycji pliku, ale te zmiany nie przetrwają restartu, jeśli plik nie zostanie zaktualizowany.

Usunelem server.properties. Co teraz?

Serwer wygeneruje nowy plik z domyślnymi wartościami przy następnym uruchomieniu. Stracisz swoja konfiguracje, ale serwer będzie dzialal. 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ę, ze nie masz literowek w nazwach opcji i ze po znaku = nie ma spacji. Opcje z blednym kluczem sa 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:

Komentarze