Minecraft Whitelist: Setup & mehr
Ein Minecraft Server ist nur so privat wie seine Whitelist. Ohne sie kann jeder mit der IP joinen; mit ihr können nur die Spieler beitreten, die namentlich eingetragen sind. Der Mechanismus ist seit den frühen Multiplayer-Builds der Java Edition Teil des Spiels, aber wie man eine Minecraft Whitelist aufsetzt und verwaltet (über das Server-Panel, mit In-Game Befehlen oder durch direktes Bearbeiten von Konfigurationsdateien) ist der Punkt, an dem die meisten Setups scheitern.
Schnellösung:
- In server.properties white-list=true setzen (oder im GPORTAL-Panel die Option Whitelist aktivieren).
- Spieler im Spiel per /whitelist add <Spielername> hinzufügen. Der Server löst den Namen automatisch in eine UUID auf.
- Optional enforce-whitelist=true setzen, damit der Server nicht-gewhitelistete Spieler sofort kickt, sobald die Liste geändert wird.
Die Bedrock Edition verwendet allowlist.json statt whitelist.json, aber die Vorgehensweise ist identisch.
Was ist eine Whitelist in Minecraft?
Eine Minecraft Whitelist ist eine serverseitige Liste von Spieleraccounts, die sich verbinden dürfen. Ist die Whitelist aktiv, prüft der Server jede eingehende Verbindung gegen diese Liste: Bekannte Spieler kommen direkt rein, alle anderen werden mit der Meldung ‚You are not whitelisted on this server.‘ abgewiesen. Sie ist der einfachste und zuverlässigste Weg, einen privaten Multiplayer-Server zu schützen: ganz ohne Plugins, Berechtigungsjonglage oder vorgeschalteten Proxy.
Die Minecraft Whitelist selbst wird in einer Datei namens whitelist.json auf der Java Edition (bzw. allowlist.json auf Bedrock) gespeichert, die im Root-Verzeichnis des Servers neben server.properties liegt. Jeder Eintrag verknüpft einen Spielernamen mit einer UUID (der einmaligen, unveränderlichen ID, die Mojang jedem Account zuweist). So bleibt ein Spieler auf der Liste, auch wenn er seinen Namen ändert. Spieler mit OP-Rechten sind standardmäßig von der Whitelist-Prüfung ausgenommen. Das sollte man wissen, bevor man sich selbst aus dem eigenen Server aussperrt.
Wie richtet man eine Whitelist auf einem Minecraft Server ein?
Es gibt drei Wege, eine Minecraft Whitelist zu verwalten, und alle schreiben intern in dieselbe whitelist.json-Datei. Welcher der richtige ist, hängt davon ab, ob man über ein Panel wie GPORTAL hostet, als Operator im Spiel sitzt oder Dateien auf einem selbst gehosteten Server bearbeitet. Im Folgenden wird jede Methode vollständig beschrieben – von der Aktivierung über das Hinzufügen von Spielern bis zum Neuladen.
GPORTAL Webinterface (Empfohlen)
Bei einem gehosteten GPORTAL Minecraft Server wird die gesamte Whitelist über eine einzige Seite verwaltet. Weder SSH, Dateieditor , noch Befehle sind erforderlich:
- Unter g-portal.com einloggen und Meine Server öffnen.
- Den gewünschten Server auswählen und auf Basiseinstellungen klicken.
- Die Option Whitelist aktivieren.
- Im Feld Whitelist die Spielernamen eintragen (einen pro Zeile).
- Änderungen speichern und den Server neu starten.
Hinweis:Spieler mit OP-Rechten werden automatisch als gewhitelistet behandelt. Admins müssen also nicht separat eingetragen werden. Sie erscheinen allerdings trotzdem im Whitelist-Feld des Panels, sobald die OP-Liste ausgelesen wird.
Minecraft Whitelist Commands
Wer als Operator bereits im Spiel ist, kann mit den Minecraft Whitelist Commands die Liste aktivieren und Spieler hinzufügen, ohne eine einzige Datei anzufassen. Alle Commands funktionieren in Einzelspieler-Sessions mit ‘Für LAN öffnen’ und aktivierten Cheats, im Multiplayer-Chat als OP sowie in der Serverkonsole:
/whitelist on → Whitelist aktivieren
/whitelist off → Whitelist deaktivieren
/whitelist add <Name> → Spieler hinzufügen
/whitelist remove <Name> → Spieler entfernen
/whitelist list → Alle gewhitelisteten Spieler anzeigen
/whitelist reload → whitelist.json von der Festplatte neu einlesen
Der Befehl /whitelist add ist der Punkt, den viele ältere Anleitungen falsch machen: Seit Java Edition 1.7.10 löst der Server den Spielernamen automatisch über die Mojang-API in eine UUID auf, sobald man ihn hinzufügt. UUIDs müssen nicht manuell nachgeschlagen oder ins JSON eingefügt werden: Der Server erledigt alles. /whitelist reload ist nur dann nötig, wenn man whitelist.json außerhalb des Spiels manuell bearbeitet hat und möchte, dass der laufende Server die Änderungen übernimmt, ohne neu starten zu müssen.
Manuelle Konfiguration über server.properties & whitelist.json
Bei selbst gehosteten Setups oder wenn weder Panel noch Konsole verfügbar sind, lässt sich die Whitelist auch durch direktes Bearbeiten zweier Dateien konfigurieren. Den Server vorher stoppen, dann:
- server.properties öffnen und white-list=false zu white-list=true ändern.
- whitelist.json im selben Verzeichnis öffnen (oder erstellen) und jeden Spieler als JSON-Objekt mit UUID und Name eintragen:
[
{
"uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
"name": "Notch"
},
{
"uuid": "853c80ef-3c37-49fd-aa49-938b674adae6",
"name": "jeb_"
}
]
UUIDs können über die öffentliche Mojang-API nachgeschlagen werden:
https://api.mojang.com/users/profiles/minecraft/ <username>
Ersetze <Benutzername> durch den aktuellen Minecraft-Namen des Spielers und die Antwort enthält dann die UUID. Sobald beide Dateien gespeichert sind, den Server starten. Von hier aus kann man im manuellen Workflow bleiben oder auf die In-Game Admin Commands umsteigen. Die Formate sind vollständig kompatibel.
Enforce Whitelist auf deinem Minecraft Server
Die Minecraft Whitelist zu aktivieren wirkt sich nur auf neue Verbindungen aus. Wer bereits auf dem Server ist, wenn man sie einschaltet, oder wer auf der Liste stand und dann entfernt wurde, bleibt verbunden, bis er sich von selbst ausloggt. Die Einstellung enforce-whitelist in server.properties ändert dieses Verhalten: Ist sie aktiv, kickt der Server sofort jeden Spieler, der nicht mehr auf der Whitelist steht, sobald die Liste neu geladen wird.
enforce-whitelist=true
Diese Einstellung wurde in Java Edition 1.17 eingeführt und ist standardmäßig deaktiviert. Sie empfiehlt sich vor allem auf Produktionsservern, auf denen die Whitelist die einzige Zugangskontrolle ist. Ohne sie hat das Entfernen eines Spielers so lange keine Wirkung, bis dieser sich zufällig ausloggt. Auf einem GPORTAL Server ist dieselbe Option in den Basiseinstellungen als separate Checkbox verfügbar. server.properties muss nicht manuell bearbeitet werden. Nach dem Aktivieren /whitelist reload in der Konsole ausführen (oder den Server neu starten), damit die Einstellung greift.
‚You Are Not Whitelisted on This Server‘ – Was das bedeutet
Versucht ein Spieler, einem Server beizutreten, auf dem er nicht auf der Whitelist steht, wird die Verbindung sofort unterbrochen, und der Client zeigt ‚You are not whitelisted on this server‘ in rot an. Der Fehler ist kein Bug, kein Versions-Mismatch und kein Netzwerkproblem: Es ist die Whitelist, die genau das tut, wofür sie eingerichtet wurde. Bei diesem Fehler sind der Reihe nach drei Dinge zu prüfen:
- die genaue Schreibweise des Spielernamens in whitelist.json oder im Panel-Feld: Groß-/Kleinschreibung spielt normalerweise keine Rolle, Tippfehler dagegen schon
- ob der Spieler seinen Minecraft-Benutzernamen kürzlich geändert hat: wurde er vor dem UUID-Matching ab 1.7.10 per Name eingetragen, klebt der alte Name auf der Liste
- ob der Server die tatsächlich bearbeitete Whitelist verwendet: bei einem Multi-Instanz-Setup ist es leicht, die Datei des falschen Servers zu aktualisieren
Wer sich als Server-Admin selbst ausgesperrt hat: OP-Rechte überschreiben die Whitelist-Prüfung, sodass der schnellste Weg ist, sich über die Konsole oder RCON zunächst den OP-Titel zu geben und dann beizutreten. Bei allgemeinen Join-Problemen, die wie ein Whitelist-Fehler aussehen, aber keiner sind (Connection refused, Timeouts, Versions-Mismatch), behandelt der dedizierte Troubleshooting-Artikel die Netzwerkseite.
FAQ
white-list=true in server.properties setzen und den Server neu starten, oder die Option Whitelist im Hosting-Panel aktivieren. Auf einem GPORTAL-Server ist das eine einzige Checkbox in den Basiseinstellungen. Nach der Aktivierung Spieler mit /whitelist add <Name> hinzufügen.
Der Command lautet /whitelist add <Spielername>, ausgeführt in der Serverkonsole oder von einem OP im Chat. Der Server schlägt die UUID des Spielers automatisch nach und es reicht der aktuelle Minecraft-Name. Um jemanden zu entfernen: /whitelist remove <Username>.
Die Whitelist bestimmt, wer sich verbinden darf; enforce-whitelist bestimmt, was mit Spielern passiert, die bereits verbunden sind, wenn die Liste geändert wird. Mit enforce deaktiviert (Standard) bleiben entfernte Spieler verbunden, bis sie sich ausloggen. Mit enforce aktiviert werden sie sofort gekickt, sobald die Liste neu geladen wird.
Ja, Bedrock verwendet eine Datei namens allowlist.json statt whitelist.json, das Prinzip ist jedoch identisch, und die In-Game-Commands sind dieselben. Auf einem GPORTAL-Bedrock-Server bietet das Panel den entsprechenden Toggle an derselben Stelle an.
Als Spieler: den Serverbesitzer bitten, /whitelist add <dein-aktueller-Name> auszuführen. Als Besitzer, der sich selbst ausgesperrt hat: über die Serverkonsole oder das Panel verbinden. OP-Rechte überschreiben standardmäßig die Whitelist, sodass man sich über die Konsole zunächst OP gibt und dann problemlos beitreten kann.
Whitelist fertig: Jetzt kommen die Richtigen rein
Eine Minecraft Whitelist gehört zu den Einstellungen, die in dreißig Sekunden aktiviert sind und danach still ihren Dienst für die gesamte Lebensdauer des Servers tun. Kombiniert man sie mit OP-Rechten für vertrauenswürdige Admins und enforce-whitelist=true für schnelle Entfernungen, hat man ein sauberes, verlässliches Zugangssystem, ganz ohne ein einziges Plugin dazwischen. Für das große Bild (Backups, Performance-Tuning, Versionsverwaltung) behandelt unser Server-Guide, was nach dem Abschließen der Tür kommt. Die einfachste Lösung bleibt aber ein GPORTAL Minecraft Server für dich und deine Freunde. Dort hält euch nichts auf!
