Hytale Server privat machenWhitelist, Passwort und Bannliste - welcher Schutz für welche Runde

Veröffentlicht am 4. Oktober 2026

Whitelist oder Passwort?

Beides schließt den Server, aber auf unterschiedliche Weise:

Für eine feste Freundesrunde ist die Whitelist die sauberere Lösung: Niemand kommt herein, nur weil das Passwort in einem Chat gelandet ist. Das Passwort spielt seine Stärke aus, wenn sich die Gruppe ständig ändert und du nicht jeden Namen einzeln eintragen willst.

Die Whitelist per Befehl

Am bequemsten verwaltest du die Whitelist per Befehl - im Spiel als Admin oder in der Konsole im Webinterface ohne Schrägstrich:

Die richtige Reihenfolge erspart dir einen Rauswurf: erst eintragen, dann einschalten. Admins kommen auch bei aktiver Whitelist hinein - mach dich deshalb vorher zum Operator, wie in Admin werden beschrieben. Dann sperrst du dich nie selbst aus.

Ist ein Spieler bereits verbunden, wenn du die Whitelist einschaltest, ohne dass er eingetragen ist, verliert er beim nächsten Beitritt den Zugang. Den Status prüfst du jederzeit mit /whitelist status.

Die whitelist.json

Hinter den Befehlen steht die Datei whitelist.json im Serververzeichnis. Darin speichert der Server, ob die Whitelist aktiv ist, und die eingetragenen Spieler - als UUID, also als feste Konto-Kennung, nicht als Name. Deshalb behält ein Spieler seinen Platz auf der Liste auch dann, wenn er seinen Namen ändert.

Die Datei lässt sich im Config-Editor bearbeiten, etwa um eine lange Liste auf einmal einzufügen. Dabei gilt dieselbe Regel wie für alle Hytale-Konfigurationsdateien: nur bei angehaltenem Server. Der Server liest die Datei beim Start und schreibt sie neu, sobald jemand per Befehl Änderungen macht. Was du an einer laufenden Instanz einträgst, ist danach weg.

Die UUID eines Spielers liefert /whoami. Wer schon einmal auf dem Server war, hat außerdem eine Datei mit seiner UUID im Ordner universe/players.

Ein Server-Passwort setzen

Das Passwort steht in der zentralen config.json des Servers, im Feld Password. Ein leerer Wert bedeutet: kein Passwort.

1. Server im Webinterface anhalten.
2. Die config.json im Config-Editor öffnen.
3. Bei Password das gewünschte Passwort in Anführungszeichen eintragen.
4. Speichern und den Server starten.

Spieler werden beim Beitritt nach dem Passwort gefragt. Wechselst du es, müssen alle das neue eingeben - genau das willst du, wenn jemand die Gruppe verlassen hat. Welche weiteren Felder in der config.json stecken, von Servername über maximale Spielerzahl bis Sichtweite, zeigt Hytale Server-Einstellungen.

Störenfriede: Kick und Bann

Auch auf einem geschlossenen Server braucht es manchmal einen Rauswurf:

• /kick Name wirft einen Spieler einmal hinaus. Er kann sofort zurück - eine Verwarnung.
• /ban Name sperrt ihn dauerhaft. Der Eintrag landet in der bans.json.
• /unban Name hebt die Sperre wieder auf.

Auf einem Whitelist-Server reicht oft schon /whitelist remove und ein Kick. Der Bann ist die stärkere Maßnahme für öffentliche Server, auf denen sonst jeder zurückkommen könnte. Weitere Moderationsbefehle stehen in Hytale Server-Befehle.

Wenn jemand trotzdem nicht hineinkommt

Die Whitelist ist eine häufige Ursache für scheinbare Verbindungsprobleme. Bevor du an Adresse oder Port zweifelst, lohnt ein Blick auf diese Punkte:

• Ist der Spieler mit genau dem Konto eingetragen, mit dem er spielt? /whitelist list zeigt es.
• Wurde die whitelist.json bei laufendem Server bearbeitet? Dann ist die Änderung womöglich überschrieben.
• Steht der Spieler versehentlich in der bans.json?
• Stimmt das Passwort, falls eines gesetzt ist?

Ist das alles in Ordnung, liegt die Ursache woanders - die Checkliste dafür steht in Verbindungsprobleme lösen, die Grundlagen zum Verbinden in Hytale Server beitreten.

Häufige Fragen