AEONHOST / WISSEN

Minecraft Whitelist einrichten: Freunde zulassen und entfernen

Mit der Whitelist bestimmst du, welche Konten deinem Minecraft-Java-Server beitreten dürfen. Trage die Java-Spielernamen zuerst ein und aktiviere danach die Whitelist in der Serverkonsole. Für Vanilla und Paper kannst du die Verwaltung über die eingebauten Java-Befehle erledigen; Paper beschreibt die Whitelist als Zugangsliste für ausgewählte Spieler (PaperMC: Next steps).

Aktualisiert am 07.10.2026

Mit der Whitelist bestimmst du, welche Konten deinem Minecraft-Java-Server beitreten dürfen. Trage die Java-Spielernamen zuerst ein und aktiviere danach die Whitelist in der Serverkonsole. Für Vanilla und Paper kannst du die Verwaltung über die eingebauten Java-Befehle erledigen; Paper beschreibt die Whitelist als Zugangsliste für ausgewählte Spieler (PaperMC: Next steps).

Die gezeigte Befehlsform ist am offiziellen Vanilla-Java-Serverartefakt für Version 26.3 geprüft (Mojang: Minecraft Java Server 26.3). Paper empfiehlt ebenfalls, die Whitelist mit den eingebauten Befehlen zu verwalten (PaperMC: Vanilla data files). Bei älteren Versionen und anderen Forks können Befehle abweichen; nutze dann /help whitelist oder die Vorschläge deiner Konsole.

Voraussetzungen

Du brauchst Zugriff auf die laufende Serverkonsole, zum Beispiel die Konsole im Panel. Alternativ kannst du die Befehle im Spielchat ausführen, wenn dein Konto dort die nötigen Befehlsrechte hat. In der Konsole steht der Befehl ohne führenden Schrägstrich; im Spielchat beginnt er mit /.

Diese Anleitung gilt für Minecraft: Java Edition. Verwende den Java-Profilnamen, mit dem sich dein Freund anmeldet, nicht einen Bedrock-Gamertag. Lasse online-mode=true aktiviert: Diese Einstellung lässt den Server Minecraft-Konten prüfen und ist von der Whitelist getrennt (PaperMC: server.properties). Ändere sie nicht als Abkürzung, wenn ein Profilname nicht erkannt wird.

Freunde hinzufügen und Whitelist einschalten

Führe die Befehle in dieser Reihenfolge aus und ersetze Spielname durch den Java-Profilnamen. In einer Panelkonsole kannst du die Zeilen ohne / eingeben:

whitelist add Spielname
whitelist list

Aktiviere die Whitelist nur, wenn sie noch ausgeschaltet ist: whitelist on. Meldet der Server, dass sie bereits aktiv ist, fahre mit whitelist list und dem Zugangstest fort. Im Spielchat setzt du einen Schrägstrich davor, zum Beispiel /whitelist add Spielname oder /whitelist on. Das Konto, das den Befehl im Chat ausführt, muss dazu berechtigt sein. Seit Java 26.3 ist white-list standardmässig true; eine bestehende server.properties kann einen anderen Wert enthalten. Auch Paper dokumentiert true als Standard (Mojang: Java 26.3 Release-Notizen, PaperMC: server.properties). Prüfe den tatsächlichen Zustand deines Servers.

Die Liste mit whitelist list sollte die eingetragenen Java-Spieler zeigen. whitelist on aktiviert die Zugangsbeschränkung. Paper dokumentiert dafür die Einstellung white-list in server.properties; normalerweise musst du die Datei dafür nicht bearbeiten, weil der Befehl die Einstellung verwaltet (PaperMC: server.properties).

Paper speichert die Einträge in whitelist.json zusammen mit der UUID und dem Namen des Spielprofils. Die Datei ist Serverdatenbestand und keine normale Konfigurationsdatei; Paper empfiehlt, sie mit /whitelist statt von Hand zu verwalten (PaperMC: Vanilla data files).

Zugang prüfen und Spieler entfernen

Bitte einen eingetragenen Freund, sich mit der Java Edition zu verbinden. Prüfe danach mit einem nicht gebannten Konto, das weder auf der Liste steht noch Operator ist, dass der Server den Beitritt verweigert. Im Vanilla-Java-26.3-Serverartefakt zählt ein Operator bei aktiver Whitelist als zugelassen. Im geprüften Paper-Quellstand gilt dieselbe Grundregel; ein Plugin kann die anschliessende Whitelist-Prüfung über ein Ereignis verändern (Mojang: Minecraft Java Server 26.3, PaperMC: PlayerList, Commit vom 6. Oktober 2026). Wenn du einer Person den Zugang entziehen willst, prüfe deshalb auch den Operator-Status und entferne ihn bei Bedarf zuerst mit deop; die Schritte findest du unter Minecraft-Operator-Rechte sicher vergeben. Vergleiche bei einer Ablehnung zuerst die Edition, den Profilnamen und die Ausgabe in der Serverkonsole.

Wenn jemand künftig keinen Zugang mehr haben soll, entferne den Eintrag und kontrolliere die Liste erneut. Ist die Person als Operator geführt, entziehe zusätzlich den Operator-Status.

whitelist remove Spielname
whitelist list

Das Entfernen aus der Liste und das Abschalten der Whitelist sind zwei verschiedene Dinge. whitelist off deaktiviert die Zugangsbeschränkung für alle; nutze diesen Befehl nur, wenn auch nicht eingetragene Spieler beitreten dürfen sollen. Vanilla Java 26.3 ruft nach whitelist remove eine Kick-Prüfung auf. Sie greift nur, wenn enforce-whitelist=true und die Whitelist aktiv ist. Paper dokumentiert false als Standard und erklärt, dass bei true nicht gelistete Spieler gekickt werden. Mit dem Paper-Standardwert blockiert das Entfernen künftige Beitritte, trennt eine laufende Sitzung aber nicht automatisch. Prüfe den Wert und die Dokumentation deiner Serverversion (Mojang: Minecraft Java Server 26.3, PaperMC: server.properties).

Häufige Fehler

  • Spieler wird nicht gefunden: Prüfe, ob es der aktuelle Java-Profilname ist. Ein Bedrock-Gamertag gehört nicht zu dieser Anleitung. Lies die genaue Meldung in der Serverkonsole, bevor du weitere Einstellungen änderst.
  • Eintrag ist vorhanden, Freund kommt trotzdem nicht hinein: Prüfe, ob whitelist list den erwarteten Namen zeigt und die Whitelist noch aktiv ist. Kontrolliere auch, ob der Freund die Java Edition und die zum Server passende Version startet.
  • Befehl wird abgelehnt: Nutze die Serverkonsole ohne /. Im Spielchat braucht dein Konto die nötige Berechtigung. Paper führt die Vanilla-Whitelist als geschützten Befehl auf; ein normaler Spieler erhält diesen Zugriff nicht automatisch (PaperMC: Permissions).
  • Du hast whitelist.json bearbeitet: Paper rät von direkten Änderungen an dieser serververwalteten Datei ab. Verwalte Einträge künftig über /whitelist und prüfe das Ergebnis mit whitelist list.

Wenn die Konsole selbst nicht verfügbar ist oder der Server beim Start Fehler meldet, hilft dir Minecraft-Server startet nicht. Für getrennte Zugriffsrechte von Administratoren und Helfern lies Minecraft-Operator-Rechte sicher vergeben; für zusätzliche Serverfunktionen findest du Hinweise unter Minecraft-Server-Plugins installieren.

Quellen