Zurück zum Blog

Minecraft server.properties erklärt: Die wichtigsten Einstellungen

Minecraft server.properties erklärt: wo die Datei liegt, wie Sie sie sicher bearbeiten und welche Werte für Gameplay, Welt, Whitelist und Netzwerk passen.

Nodesty-Team10 Min. LesezeitGameserver
Der Schriftzug server.properties mit view-distance, difficulty und whitelist auf dunklem Nodesty-Hintergrund

Die Minecraft server.properties ist die zentrale Konfigurationsdatei eines Java-Edition-Servers: Spielmodus und Schwierigkeit, die geladene Welt, wer beitreten darf, der Port, auf dem der Server lauscht, und wie viel der Welt er für jeden Spieler verarbeitet, all das wird hier festgelegt. Es ist eine einfache Textdatei, doch eine einzige falsche Zeile kann Spieler aussperren, eine leere Welt laden oder den Server für jeden öffnen.

In dieser Anleitung erklären wir, wo die Datei liegt und wie Sie sie sicher bearbeiten, die wichtigsten Einstellungen Gruppe für Gruppe, eine Tabelle der am häufigsten geänderten Schlüssel, MOTD-Farbcodes, ein Beispiel und die häufigsten Fehler. Wenn Sie Ihren Server noch nicht eingerichtet haben, beginnen Sie mit unserer Anleitung Minecraft Server erstellen.

Wo die Datei liegt und wie Sie sie bearbeiten

Die Datei ist nicht im Download enthalten. Der Server legt sie beim ersten Start in dem Ordner an, aus dem er gestartet wird; das ist normalerweise der Ordner mit der Server-Jar und der eula.txt. Auf einem Linux-Server öffnen Sie sie per SSH:

cd ~/minecraft-server
nano server.properties

Jede Zeile hat die Form schlüssel=wert, eine Einstellung pro Zeile:

difficulty=easy
max-players=20
level-type=minecraft\:normal
  • Schlüssel und die Werte true/false werden kleingeschrieben. Lassen Sie keine Leerzeichen um das = oder am Zeilenende stehen.
  • Zeilen, die mit # beginnen, sind Kommentare. Der Server schreibt die Datei beim Start neu, eigene Kommentare bleiben daher nicht erhalten. Der Backslash vor einem Doppelpunkt (minecraft\:normal) ist normal.
  • Ein leerer Wert wie server-ip= bedeutet „nicht gesetzt“.

Änderungen brauchen einen Neustart. Der Server liest die Datei nur beim Start und kann sie im laufenden Betrieb zurückschreiben, etwa wenn Sie die Whitelist per Befehl einschalten. Stoppen Sie den Server mit stop, bearbeiten Sie die Datei und starten Sie ihn dann wieder; sonst kann Ihre Änderung überschrieben werden.

Die Schlüssel hängen von der Version ab. Minecraft fügt zwischen den Versionen Schlüssel hinzu, benennt sie um und entfernt sie. Die folgenden Standardwerte sind die, die ein Vanilla-Server erzeugt. Fehlt ein Schlüssel aus dieser Anleitung in Ihrer Datei, vertrauen Sie der Datei, die Ihr eigener Server erzeugt hat.

Gameplay-Einstellungen

  • gamemode (Standard survival): Der Modus, in dem neue Spieler starten: survival, creative, adventure oder spectator.
  • force-gamemode (Standard false): Mit true werden Spieler bei jedem Beitritt in den Standard-Spielmodus zurückgesetzt.
  • difficulty (Standard easy): peaceful, easy, normal oder hard.
  • hardcore (Standard false): Mit true wird eine neu erstellte Welt zur Hardcore-Welt: Die Schwierigkeit ist hard, und gestorbene Spieler können nur noch zuschauen.
  • spawn-protection (Standard 16): Der Radius um den Welt-Spawn, in dem nur Operatoren bauen können; 16 schützt ein Quadrat von 33 x 33 Blöcken. 0 schaltet den Schutz aus. Er greift erst, wenn der Server mindestens einen Operator hat; deshalb können neue Spieler in Spawn-Nähe manchmal „keine Blöcke abbauen“.
  • allow-flight (Standard false): Diese Einstellung gibt niemandem Flugrechte. Mit false wirft der Server Spieler im Überlebensmodus hinaus, die mehrere Sekunden in der Luft bleiben. Setzen Sie true, wenn ein Plugin oder Mod Spieler fliegen lässt oder Spieler zu Unrecht wegen Fliegens gekickt werden.
  • pvp: In älteren Versionen legt dieser Schlüssel (Standard true) fest, ob Spieler einander verletzen können. In aktuellen Versionen, seit 1.21.9, ist es stattdessen eine Spielregel: gamerule pvp false.

Dasselbe Update hat auch allow-nether, spawn-monsters und enable-command-block zu Spielregeln gemacht. Finden Sie einen solchen Schlüssel nicht in Ihrer Datei, geben Sie in der Konsole gamerule ein und drücken Sie Tab, um die Regeln Ihrer Version zu sehen. Spielregeln behandeln wir in Minecraft Server Befehle.

Welt-Einstellungen

  • level-name (Standard world): Der Name des Weltordners. Der Server lädt den Ordner mit diesem Namen; gibt es keinen, erzeugt er eine neue Welt. Um eine hochgeladene Welt zu nutzen, legen Sie ihren Ordner neben die Server-Jar und tragen den exakten Ordnernamen hier ein.
  • level-seed (Standard leer): Der Seed für eine neue Welt. Leer bedeutet ein zufälliger Seed.
  • level-type (Standard minecraft:normal): Die Weltvorlage, zum Beispiel minecraft:flat, minecraft:large_biomes oder minecraft:amplified.
  • generate-structures (Standard true): Ob Strukturen wie Dörfer generiert werden.
  • max-world-size (Standard 29999984): Der größte Radius in Blöcken, den die Weltgrenze haben kann. Um das Gebiet zu begrenzen, das Spieler erkunden, ist eine Weltgrenze wie in unserer Anleitung zu Minecraft Server Lag meist das bessere Werkzeug.

level-seed, level-type und generate-structures werden beim Erstellen einer Welt verwendet. Eine spätere Änderung verändert eine bestehende Welt nicht.

Spieler und Zugang

  • max-players (Standard 20): Wie viele Spieler gleichzeitig online sein können.
  • white-list: Mit true können nur Spieler aus der whitelist.json beitreten. Ältere Versionen erzeugen false; eine frische Installation einer aktuellen Version (26.3 und neuer) erzeugt true, sehen Sie also in Ihrer eigenen Datei nach. Spieler fügen Sie mit whitelist add hinzu, wie in der Befehlsanleitung gezeigt.
  • enforce-whitelist (Standard false): Mit true werden Online-Spieler, die nicht auf der Liste stehen, beim Aktivieren oder Neuladen der Whitelist hinausgeworfen.
  • online-mode (Standard true): Der Server prüft jeden beitretenden Spieler über die Kontoserver von Minecraft. Lassen Sie die Einstellung an.
  • op-permission-level (Standard 4): Die Berechtigungsstufe, die op vergibt. Für Ränge mit feineren Rechten verwenden Sie ein Plugin; siehe unsere LuckPerms Anleitung.
  • player-idle-timeout (Standard 0): Nach wie vielen Minuten untätige Spieler gekickt werden. 0 bedeutet nie.

Warum online-mode=false unsicher ist: Kein Konto wird mehr geprüft, jeder kann also unter beliebigem Namen beitreten, auch unter Ihrem, und übernimmt Inventar und Operator-Rechte dieses Spielers. Außerdem ändern sich die UUIDs der Spieler, sodass bestehende Inventare und Ränge wie verloren wirken. Die einzige übliche Ausnahme ist ein Backend-Server hinter einem Proxy: Dort prüft der Proxy die Konten, und eine Firewall verhindert, dass Spieler das Backend direkt erreichen, wie in unserer Anleitung Minecraft Velocity Netzwerk einrichten beschrieben.

Netzwerk-Einstellungen

  • server-port (Standard 25565): Der TCP-Port, auf dem der Server lauscht. Bei einem anderen Port müssen Spieler ihn an die Adresse anhängen (example.com:25570), sofern Sie keinen SRV-Eintrag anlegen; siehe Minecraft Server mit Domain verbinden.
  • server-ip (Standard leer): Lassen Sie den Wert leer, damit der Server auf allen Adressen der Maschine lauscht. Setzen Sie ihn nur, wenn die Maschine mehrere IP-Adressen hat und der Server eine davon nutzen soll. Eine Domain gehört nicht hierher.
  • motd (Standard A Minecraft Server): Der Text unter dem Servernamen in der Mehrspieler-Liste; siehe unten.
  • enable-status (Standard true): Mit false wirkt der Server in der Serverliste offline, nimmt aber weiterhin Verbindungen an.
  • enable-query (Standard false): Öffnet auf query.port einen UDP-Abfragedienst, der Serverinformationen herausgibt. Schalten Sie ihn nur ein, wenn eine Serverliste oder ein Monitoring-Werkzeug ihn verlangt.
  • enable-rcon (Standard false), rcon.port (Standard 25575) und rcon.password: Eine Fernkonsole über TCP. Ohne Passwort startet RCON nicht.

Der Port muss auch in der Firewall offen sein: sudo ufw allow 25565/tcp unter Ubuntu und Debian oder sudo firewall-cmd --permanent --add-port=25565/tcp gefolgt von sudo firewall-cmd --reload unter AlmaLinux.

Geben Sie RCON nicht frei. RCON gewährt vollen Konsolenzugriff, und das Protokoll überträgt das Passwort unverschlüsselt. Verwenden Sie ein langes, zufälliges Passwort, öffnen Sie Port 25575 niemals zum Internet und verbinden Sie sich vom Server selbst oder über einen SSH Tunnel.

Performance-Einstellungen

  • view-distance (Standard 10, Bereich 3–32): Der Radius der Welt in Chunks, der an jeden Spieler gesendet wird.
  • simulation-distance (Standard 10, Bereich 3–32): Der Radius, in dem Mobs, Pflanzen und Redstone verarbeitet werden.
  • network-compression-threshold (Standard 256): Pakete ab dieser Größe in Bytes werden komprimiert. Lassen Sie den Standardwert; -1 schaltet die Kompression aus, was nur für Backend-Server hinter einem Proxy auf derselben Maschine oder im privaten Netz sinnvoll ist.
  • max-tick-time (Standard 60000): Dauert ein einzelner Tick länger als so viele Millisekunden, stoppt der Watchdog den Server als abgestürzt. -1 schaltet den Watchdog aus, verdeckt das Problem aber nur, statt es zu lösen.
  • sync-chunk-writes (Standard true): Schreibt Chunks synchron, damit ein Absturz die Welt nicht beschädigt. Lassen Sie die Einstellung an.
  • entity-broadcast-range-percentage (Standard 100, Bereich 10–1000): Aus welcher Entfernung Entities an Spieler gesendet werden. 50 halbiert die Distanz und spart Bandbreite, Mobs erscheinen dafür später.

Für die meisten Server passen 8–10 für view-distance und 6–8 für simulation-distance. Wie Sie messen, ob diese Werte Ihr Engpass sind, erklärt die oben verlinkte Lag-Anleitung.

Die am häufigsten geänderten Schlüssel

SchlüsselStandardEmpfehlung
motdA Minecraft ServerIhr Servername und eine kurze Zeile
max-players20Eine Zahl, die RAM und Prozessor wirklich tragen
difficultyeasynormal oder hard für Survival-Server
white-listfalse (true ab 26.3)true für Freunde und private Communitys
online-modetrueAuf true lassen
server-port25565Beibehalten, solange sich nicht mehrere Server eine IP teilen
level-nameworldDer exakte Ordnername Ihrer Welt
view-distance108–10
simulation-distance106–8
spawn-protection160, wenn ein Plugin wie WorldGuard den Spawn schützt
enable-rconfalseAuf false lassen, wenn kein Werkzeug es braucht; nie freigeben

MOTD mit Farbcodes formatieren

Die MOTD hat bis zu zwei Zeilen; \n beginnt die zweite. Farben und Stile setzen Sie mit dem Paragrafenzeichen § und einem folgenden Zeichen: §0–§9 und §a–§f für Farben, §l fett, §o kursiv, §n unterstrichen und §r zum Zurücksetzen. In der Datei schreiben Sie das Paragrafenzeichen als Escape-Sequenz \u00A7, die in jeder Version funktioniert. Aktuelle Versionen akzeptieren auch ein direkt getipptes §, wenn Ihr Editor die Datei als UTF-8 speichert.

motd=\u00A7a\u00A7lMein Survival Server\u00A7r\n\u00A77Nur Freunde \u00A7f| \u00A7eJava Edition

Das ergibt eine fette grüne erste Zeile und eine graue, weiße und gelbe zweite Zeile. Halten Sie beide Zeilen kurz, damit sie in die Serverliste passen.

Beispielauszug aus der server.properties

Ein sinnvoller Ausgangspunkt für einen privaten Survival-Server. Das sind die Zeilen, die Sie prüfen sollten; den Rest der Datei lassen Sie so, wie der Server ihn erzeugt hat:

motd=\u00A7aMein Survival Server\u00A7r\n\u00A77Nur Freunde
max-players=20
gamemode=survival
difficulty=normal
white-list=true
enforce-whitelist=true
online-mode=true
server-port=25565
server-ip=
level-name=world
view-distance=8
simulation-distance=6
enable-rcon=false

Unterschiede bei Paper und Bedrock

Paper, Spigot und Purpur lesen die server.properties weiterhin, und alles oben Genannte gilt. Sie bringen zusätzlich eigene Dateien mit: bukkit.yml, spigot.yml und im Ordner config die Dateien paper-global.yml und paper-world-defaults.yml. Manche davon können einen Wert pro Welt überschreiben, zum Beispiel die Sichtweite und Simulationsdistanz in der spigot.yml. Wirkt eine Einstellung unter Paper nicht, sehen Sie dort nach. Plugins speichern ihre Einstellungen im Ordner plugins; siehe Minecraft Plugins installieren.

Auch der Bedrock Dedicated Server hat eine Datei namens server.properties, allerdings mit anderen Schlüsseln (zum Beispiel allow-list und Port 19132); wir behandeln sie in Minecraft Bedrock Server erstellen.

Häufige Fehler

  • Bearbeiten, während der Server läuft: Die Änderung wird nicht übernommen und kann überschrieben werden. Stoppen, bearbeiten, starten.
  • Tippfehler in Schlüssel oder Wert: Der Server warnt Sie nicht deutlich. Ein falsch geschriebener Schlüssel wird ignoriert, und der richtige Schlüssel behält seinen Standardwert; ein ungültiger Wert wie view-distance=zehn wird durch den Standardwert ersetzt. Öffnen Sie die Datei nach dem Neustart erneut und prüfen Sie, ob Ihr Wert noch dort steht.
  • Falscher level-name: Der Server findet keinen Ordner mit diesem Namen und erzeugt eine neue, leere Welt. Ihre alte Welt wird nicht gelöscht: Korrigieren Sie den Namen, achten Sie unter Linux auf Groß- und Kleinschreibung und starten Sie neu.
  • online-mode=false auf einem öffentlichen Server: Jeder kann sich als beliebiger Spieler anmelden. Schalten Sie die Einstellung wieder ein.
  • Portkonflikte: Zwei Server mit demselben server-port können nicht auf einer IP-Adresse laufen; der zweite bricht mit FAILED TO BIND TO PORT ab. Prüfen Sie, was den Port belegt, und geben Sie jedem Server einen eigenen, wie in Port bereits belegt erklärt:
sudo ss -tlnp | grep 25565

Legen Sie vor größeren Änderungen mit cp server.properties server.properties.bak eine Kopie an.

Minecraft Server bei Nodesty

Die Pakete für Minecraft Server mieten von Nodesty laufen in Frankfurt mit einem AMD Ryzen 9 9950X Prozessor mit bis zu 5,7 GHz, NVMe-Speicher und DDoS-Schutz. Mit Paper, Forge oder Fabric starten Sie in wenigen Minuten und bearbeiten die server.properties und alle anderen Dateien mit vollem Administratorzugriff. Tägliche Backups sind bei Gameservern kostenlos und werden 7 Tage aufbewahrt.

Minecraft ist eine Marke der Mojang AB. Nodesty ist nicht mit Mojang oder Microsoft verbunden und wird nicht von ihnen unterstützt.

Häufig gestellte Fragen

Wo liegt die Datei server.properties?

Sie liegt in dem Ordner, aus dem der Server gestartet wird, normalerweise direkt neben der Server-Jar und der eula.txt. Die Datei ist nicht im Download enthalten; der Server legt sie beim ersten Start selbst an. Auf einem gemieteten Server erreichen Sie sie per SFTP, SSH oder über den Dateimanager Ihres Panels.

Muss ich den Server nach einer Änderung an der server.properties neu starten?

Ja. Der Server liest die Datei nur beim Start, eine Änderung wirkt also erst beim nächsten Start. Am sichersten stoppen Sie den Server mit dem Befehl stop, bearbeiten und speichern die Datei und starten den Server danach wieder.

Warum werden meine Änderungen in der server.properties zurückgesetzt?

Meist gibt es zwei Ursachen. Entweder wurde die Datei bearbeitet, während der Server lief, und der Server hat seine eigene Fassung zurückgeschrieben, oder ein Schlüssel oder Wert war falsch geschrieben, sodass der Server ihn ignoriert und den Standardwert verwendet hat. Stoppen Sie zuerst den Server, prüfen Sie die Schreibweise und sehen Sie nach dem Neustart noch einmal in die Datei.

Ist es sicher, online-mode auf false zu setzen?

Nicht auf einem Server, den Spieler direkt erreichen. Ist online-mode aus, werden Konten nicht mehr geprüft, und jeder kann unter beliebigem Namen beitreten, auch unter dem Namen eines Operators. Die einzige übliche Ausnahme sind Backend-Server hinter einem Proxy wie Velocity; dort prüft der Proxy die Spieler und eine Firewall blockiert direkte Verbindungen.

Warum fehlt pvp in meiner server.properties?

Seit Minecraft 1.21.9 ist pvp kein Schlüssel der server.properties mehr. Die Einstellung wurde zusammen mit einigen anderen zu einer Spielregel; in aktuellen Versionen schalten Sie PvP mit dem Befehl gamerule pvp false aus. In älteren Versionen steht die Zeile pvp weiterhin in der Datei.

Wie füge ich der MOTD Farben hinzu?

Setzen Sie ein Paragrafenzeichen und einen Code vor den Text, zum Beispiel das Paragrafenzeichen gefolgt von a für Grün oder von l für Fett. In der Datei steht die Escape-Sequenz \u00A7 für das Paragrafenzeichen und funktioniert in jeder Version. Mit \n beginnt die zweite Zeile der MOTD.

Nodesty

Über den Autor

Nodesty-Team · Infrastruktur und Support

Das Nodesty-Team betreibt unsere Server, unser Netzwerk und unseren DDoS-Schutz im Alltag und beantwortet Support-Anfragen rund um die Uhr. Diese Ratgeber entstehen aus dieser Arbeit.

Verwandte Artikel

Starte deinen Server jetzt.

Erstellen, wachsen und skalieren Sie Ihre Projekte grenzenlos auf der Premium-Infrastruktur von Nodesty.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································