Die Datei server.properties steuert die zentralen Grundeinstellungen eines Minecraft-Java-Servers: Port, maximale Spielerzahl, Whitelist, Sichtweite, Weltgenerierung, Resource Packs, RCON und seit neueren Versionen auch das Minecraft Server Management Protocol.
Dieser Guide erklärt die aktuelle Einstellungsliste für Minecraft Java Edition 26.2 anhand der aktuellen PaperMC-Referenz und der Mojang-Release-Notes. Paper bildet die Vanilla-Einstellungen ab und ergänzt bei einzelnen Optionen eigenes Verhalten; solche Paper-spezifischen Unterschiede kennzeichnen wir.
Geprüfter Stand: 21. August 2026 | Minecraft: Java Edition 26.2 | Referenz: Paper 26.2 / aktuelle Mojang-Serveränderungen.
server.properties richtig bearbeiten
- Stoppt den Server vollständig, bevor ihr die Datei ändert.
- Erstellt vor größeren Änderungen ein Backup.
- Öffnet
server.propertiesmit einem Texteditor. - Ändert nur die gewünschten Werte hinter dem Gleichheitszeichen.
- Speichert die Datei und startet den Server neu.
- Prüft beim Start die Konsole auf ungültige Werte oder Bindungsfehler.
Die meisten Einstellungen werden beim Serverstart eingelesen. Für laufend änderbare Gameplay-Regeln wurden mehrere frühere Properties inzwischen in Game Rules verschoben; dazu unten mehr.
Zugriff, Spieler und Serverliste
| Property | Default | Bedeutung |
|---|---|---|
max-players | 20 | Maximale Zahl gleichzeitig verbundener Spieler. |
online-mode | true | Prüft beitretende Spieler gegen die Minecraft-Accountdatenbank. Das Abschalten entfernt diese Authentifizierung und sollte nicht als normale Lösung für Zugriffsprobleme verwendet werden. |
white-list | false | Aktiviert die Whitelist; nur eingetragene Spieler dürfen beitreten. |
enforce-whitelist | false | Entfernt Spieler aus der Sitzung, wenn sie bei aktiver Durchsetzung nicht auf der Whitelist stehen. |
player-idle-timeout | 0 | Zeit in Minuten bis inaktive Spieler gekickt werden; 0 deaktiviert den Timeout. |
motd | A Minecraft Server | Text, der in der Serverliste angezeigt wird. |
enable-status | true | Erlaubt Statusabfragen für die Serverliste. Bei false kann der Server dort offline wirken, obwohl direkte Verbindungen weiterhin möglich sind. |
hide-online-players | false | Verbirgt die Spielerliste in Statusantworten. |
enforce-secure-profile | true | Verlangt bei Verbindungen ein von Mojang signiertes öffentliches Profil-Schlüsselpaar. |
prevent-proxy-connections | false | Versucht Verbindungen abzuweisen, wenn Netzwerkherkunft und Mojang-Authentifizierung nicht zusammenpassen. |
accept-transfers | false | Erlaubt Transfers von Spielern aus anderen Servern über das Transfer-Protokoll. |
Netzwerk, Port und Datenübertragung
| Property | Default | Bedeutung |
|---|---|---|
server-ip | leer | IP-Adresse, an die der Server gebunden wird. Leer bedeutet alle passenden Interfaces; tragt hier nicht ohne Grund eure öffentliche IP ein. |
server-port | 25565 | Port für normale Spieler-Verbindungen. |
network-compression-threshold | 256 | Paketgröße in Bytes, ab der Netzwerkpakete komprimiert werden. Negative Werte deaktivieren die Kompression. |
rate-limit | 0 | Paket-Ratenlimit; 0 deaktiviert es. |
use-native-transport | true | Aktiviert auf unterstützten Linux-Systemen nativen Netzwerktransport. |
entity-broadcast-range-percentage | 100 | Prozentualer Faktor dafür, aus welcher Entfernung Entitäten an Clients übertragen werden. Paper nennt einen Bereich von 10 bis 1000. |
Welt, Spielmodus und Generierung
| Property | Default | Bedeutung |
|---|---|---|
difficulty | easy | Standardschwierigkeit: peaceful, easy, normal oder hard. |
gamemode | survival | Standard-Spielmodus für Spieler. |
force-gamemode | false | Setzt Spieler beim erneuten Beitritt auf den konfigurierten Standard-Spielmodus zurück. |
hardcore | false | Aktiviert Hardcore-Verhalten; verstorbene Spieler werden zu Zuschauern. |
level-name | world | Name des Weltordners beziehungsweise der geladenen Welt. |
level-seed | leer | Seed für eine neu erzeugte Welt; leer erzeugt einen zufälligen Seed. |
level-type | minecraft:normal | Weltgenerator-Typ. Verwendet nur Werte, die eure konkrete Serverversion unterstützt. |
generator-settings | {} | JSON-Einstellungen für angepasste Weltgenerierung. |
generate-structures | true | Steuert, ob Strukturen wie Dörfer bei der Weltgenerierung erzeugt werden. |
max-world-size | 29999984 | Begrenzt den maximalen Radius der initial erzeugbaren Welt; ersetzt nicht die World Border. |
spawn-protection | 16 | Schutzbereich um den Spawn. 0 deaktiviert ihn; laut Paper muss mindestens ein Operator existieren, damit der Schutz greift. |
Sichtweite, Simulation und Server-Ticks
| Property | Default | Bedeutung |
|---|---|---|
view-distance | 10 | Serverseitige Sichtweite in Chunks je Richtung. Paper nennt 3 bis 32 als Bereich. |
simulation-distance | 10 | Radius in Chunks, in dem Entitäten und Weltlogik aktiv simuliert werden; Paper nennt 3 bis 32. |
pause-when-empty-seconds | -1 bei Paper | Zeit bis ein leerer Server pausiert. Paper deaktiviert die Funktion standardmäßig, weil Plugins davon überrascht werden können. Mojang führte die Property ursprünglich mit einem anderen Vanilla-Default ein; prüft deshalb eure Server-Software. |
max-tick-time | 60000 | Maximale Tickdauer in Millisekunden, bevor der Watchdog den Server als festgefahren behandelt. -1 deaktiviert den Watchdog. |
max-chained-neighbor-updates | 1000000 | Grenze für aufeinanderfolgende Nachbarblock-Updates; negative Werte deaktivieren die Grenze. |
sync-chunk-writes | true | Aktiviert synchrone Chunk-Schreibvorgänge. Paper weist darauf hin, dass diese Property dort standardmäßig ohne zusätzliche System-Property keine Wirkung hat. |
region-file-compression | deflate | Kompression für Region-Dateien. Paper dokumentiert deflate, lz4, none sowie gzip; gzip ist Paper-spezifisch. |
Operatoren, Befehle und Diagnose
| Property | Default | Bedeutung |
|---|---|---|
op-permission-level | 4 | Standard-Berechtigungsstufe für Operatoren. |
function-permission-level | 2 | Berechtigungsstufe für Funktionen; zulässig sind laut Paper 1 bis 4. |
broadcast-console-to-ops | true | Sendet Konsolenbefehls-Ausgaben an Online-Operatoren. |
broadcast-rcon-to-ops | true | Sendet RCON-Befehls-Ausgaben an Online-Operatoren. |
debug | false | Aktiviert den Debug-Modus des Servers. |
log-ips | true | Steuert, ob Spieler-IP-Adressen vom Server protokolliert werden. Plugins können unabhängig davon eigene Logs führen. |
bug-report-link | leer | URL für den Button zum Melden von Serverfehlern im Client-Menü. |
enable-code-of-conduct | false | Aktiviert die seit 1.21.9 unterstützten Code-of-Conduct-Dateien im Unterordner codeofconduct. |
Query, RCON und JMX
| Property | Default | Bedeutung |
|---|---|---|
enable-query | false | Aktiviert den GameSpy4-kompatiblen Query-Listener für Serverinformationen. |
query.port | 25565 | Port des Query-Dienstes. |
enable-rcon | false | Aktiviert Remote Console. Nur mit starkem Passwort und abgesicherter Netzwerkfreigabe verwenden. |
rcon.port | 25575 | Port des RCON-Dienstes. |
rcon.password | leer | Passwort für RCON. Bei aktivem RCON niemals leer oder trivial lassen. |
enable-jmx-monitoring | false | Aktiviert das Minecraft-Server-MBean für Tick-Zeit-Monitoring; zusätzlich sind Java/JMX-Startparameter erforderlich. |
Resource Packs und Data Packs
| Property | Default | Bedeutung |
|---|---|---|
resource-pack | leer | URL zum Server-Resource-Pack. |
resource-pack-id | leer | UUID des angebotenen Resource Packs. |
resource-pack-sha1 | leer | SHA-1-Hash zur Verifikation des heruntergeladenen Resource Packs; Paper empfiehlt die Angabe. |
resource-pack-prompt | leer | Text, der beim Resource-Pack-Dialog angezeigt wird. |
require-resource-pack | false | Kick bei Ablehnung des benötigten Resource Packs, wenn auf true. |
initial-enabled-packs | vanilla | Kommagetrennte Data Packs, die bei der Welterstellung standardmäßig aktiviert werden. |
initial-disabled-packs | leer | Kommagetrennte Data Packs, die bei der Welterstellung nicht automatisch aktiviert werden. |
Spam- und Textfilter-Einstellungen
| Property | Default | Bedeutung |
|---|---|---|
chat-spam-threshold-seconds | 10 | Seit Minecraft 26.2 getrennte Schwelle für Chat-Spam. 0 deaktiviert die zugehörigen Auto-Kicks. |
command-spam-threshold-seconds | 10 | Seit Minecraft 26.2 getrennte Schwelle für Command-Spam. 0 deaktiviert die zugehörigen Auto-Kicks. |
text-filtering-config | leer | Pfad zu einer Textfilter-Konfiguration; leer deaktiviert sie. |
text-filtering-version | 0 | Version des Textfilter-Konfigurationsformats; Paper dokumentiert 0 und 1. |
Mojang beschreibt die beiden neuen 26.2-Spamwerte als getrennte Zähler für Nachrichten und Befehle. Die Default-Schwelle beträgt jeweils 10.
Minecraft Server Management Protocol
Mojang führte mit Java 1.21.9 eine JSON-RPC-basierte Management-Schnittstelle über WebSocket ein. Sie ist standardmäßig deaktiviert und sollte nicht ohne Authentifizierung und korrektes TLS-Setup öffentlich exponiert werden.
| Property | Default | Bedeutung |
|---|---|---|
management-server-enabled | false | Aktiviert die Management-Schnittstelle. |
management-server-host | localhost | Host/Interface, an das der Management-Dienst gebunden wird. |
management-server-port | 0 | Port des Management-Dienstes; 0 lässt einen verfügbaren Port wählen. |
management-server-secret | leer | Authentifizierungs-Secret. Mojang dokumentiert 40 alphanumerische Zeichen; bei leerem Wert wird ein Secret erzeugt. |
management-server-tls-enabled | true | Aktiviert TLS für die Management-Schnittstelle. |
management-server-tls-keystore | leer | Pfad zum TLS-Keystore. Bei aktivem TLS startet der Dienst ohne benötigten Keystore nicht korrekt. |
management-server-tls-keystore-password | leer | Keystore-Passwort; Mojang unterstützt auch Environment-Variable beziehungsweise JVM-Argument. |
status-heartbeat-interval | 0 | Intervall für Heartbeat-Benachrichtigungen des Management Servers; 0 deaktiviert sie. |
Diese alten server.properties gibt es nicht mehr
Viele ältere Tutorials sind für Minecraft 26.2 veraltet. Mojang hat mehrere frühere Properties entfernt:
| Entfernte Property | Aktueller Ersatz |
|---|---|
allow-nether | Game Rule allowEnteringNetherUsingPortals |
spawn-monsters | Game Rule spawnMonsters |
enable-command-block | Game Rule commandBlocksEnabled |
pvp | Game Rule pvp |
spawn-animals | bereits seit 1.21.2 aus server.properties entfernt |
spawn-npcs | bereits seit 1.21.2 aus server.properties entfernt |
Die ersten vier wurden mit Java 1.21.9 bewusst in Game Rules verschoben, damit sie während des laufenden Servers geändert werden können. Wer eine alte Beispiel-Datei kopiert, sollte diese Werte daher nicht einfach wieder eintragen.
Sichere Basis-Konfiguration für einen privaten Server
Für einen privaten Freundes-Server sind folgende Punkte typischerweise relevanter als exotische Tuning-Werte:
online-mode=true
white-list=true
enforce-whitelist=true
max-players=8
server-port=25565
view-distance=10
simulation-distance=10
enable-rcon=false
management-server-enabled=falseDie Spielerzahl 8 ist hier nur ein Beispiel und keine technische Empfehlung. Passt sie an eure Gruppe an. Lasst Authentifizierung und administrative Remote-Schnittstellen aktiviert beziehungsweise deaktiviert, wie es euer konkretes Sicherheitskonzept verlangt; RCON und Management API solltet ihr nicht nur „für später“ offen ins Internet stellen.
Häufige Fragen zu server.properties
server-port steht standardmäßig auf 25565. Der Query-Dienst nutzt ebenfalls standardmäßig 25565, RCON dagegen 25575.
Setzt white-list=true. Mit enforce-whitelist=true wird die Whitelist zusätzlich konsequent gegenüber bereits verbundenen Spielern durchgesetzt.
Nein. Mojang entfernte pvp und allow-nether mit Java 1.21.9 aus server.properties und ersetzte sie durch Game Rules.
Minecraft 26.2 trennt die Spam-Schwellen in chat-spam-threshold-seconds und command-spam-threshold-seconds. Beide stehen standardmäßig auf 10.
view-distance bestimmt, wie weit Weltinformationen an Clients gesendet werden. simulation-distance legt fest, in welchem Chunk-Radius serverseitige Welt- und Entitätslogik aktiv simuliert wird.
Für normale öffentliche oder private Internet-Server sollte online-mode grundsätzlich aktiviert bleiben, damit Verbindungen gegen gültige Minecraft-Accounts geprüft werden. Das Abschalten entfernt diese Authentifizierung und ist kein allgemeiner Troubleshooting-Schritt.
Quellen
- PaperMC – server.properties reference – aktuelle Properties, Defaults und Paper-spezifische Hinweise.
- Mojang – Minecraft Java Edition 26.2 – neue Chat-/Command-Spam-Properties.
- Mojang – Minecraft Java Edition 1.21.9 – Management Server, Code of Conduct und in Game Rules verschobene Properties.
- Mojang – Minecraft Java Edition 1.21.2 – pause-when-empty-seconds sowie entfernte spawn-animals/spawn-npcs.
- PaperMC – Basic troubleshooting – Server vor Dateiänderungen stoppen und Backup anlegen.