Whitelist auf einem Project Zomboid-Server einrichten

Eine Whitelist sperrt deinen Server auf eine vorgenehmigte Spielerliste. Wer nicht drauf ist, wird beim Verbinden abgewiesen. Das ist der einfachste Weg, zufällige Griefer fernzuhalten. Setup dauert 5 Minuten.

Schritt 1 — Whitelist-Modus in Pterodactyl.ini aktivieren

Server zuerst stoppen. Dann öffnen:

/home/container/.cache/Server/Pterodactyl.ini

Diese zwei Zeilen finden und ändern:

Open=false
Public=false

Einstellung	Effekt
`Open=true`	Jeder kann verbinden (Standard)
`Open=false`	Whitelist nötig zum Verbinden
`Public=false`	Versteckt vom öffentlichen Server-Browser

Speichern und Server starten.

Schritt 2 — Spieler einzeln hinzufügen (Konsolen-Methode)

In der Server-Konsole (Panel → Console-Tab):

adduser "PlayerName" "password"

Das Passwort wird das Login-Passwort des Spielers für deinen Server.

Für mehrere Spieler adduser jeweils ausführen:

adduser "Alice" "alicepw123"
adduser "Bob" "bobpw456"
adduser "Carol" "carolpw789"

Schritt 3 — Bereits verbundene Spieler hinzufügen (Bulk-Methode)

Sind Spieler verbunden, wenn du Whitelist anschaltest, alle auf einmal hinzufügen:

addalltowhitelist

Das whitelistet jeden aktuell verbundenen Spieler. Einmal nach Open=false ausführen.

Schritt 4 — Whitelist testen

Lass einen Freund (nicht auf Liste) verbinden. Er sollte sehen:

Server is closed. Contact server administrator.

Spieler von Whitelist entfernen

removeuserfromwhitelist "PlayerName"

Oder via setaccesslevel:

setaccesslevel "PlayerName" "none"

Wo die Whitelist gespeichert wird

Die Whitelist liegt in der SQLite-Datenbank:

/home/container/.cache/db/Pterodactyl.db

Drinnen hat die whitelist-Tabelle Spalten: username, password (bcrypt-gehasht), accesslevel, banned, steamid. Mit DB Browser for SQLite direkt editierbar.

Sicherheitshinweis: Passwörter sind bcrypt-Hashes, nicht Klartext. Verlorene Passwörter nicht wiederherstellbar — nur per changepwd zurücksetzen.

Whitelist + Steam-Authentifizierung (empfohlen für öffentliche Server)

Wenn dein Server am offenen Internet hängt, auch Steam-Auth aktivieren. In Pterodactyl.ini:

SteamScoreboard=true
SteamPort1=8766
SteamPort2=8767

Friends-only Quick-Setup

Für kleinen Server (5-10 Freunde):

Open=true initial, damit Freunde joinen
Wenn alle drin: addalltowhitelist aus Konsole
Open=false in .ini-Datei
Server neu starten

Häufige Probleme

"Server is closed" selbst für mich als Admin. Du bist nicht in der Whitelist. Füge dich hinzu: adduser "DeinName" "deinpw", dann grantadmin "DeinName".

adduser sagt "user already exists". Spieler ist schon in DB, nur nicht whitelisted. addusertowhitelist "PlayerName" nutzen.

Whitelist scheint nicht zu funktionieren. Drei mögliche Ursachen: 1) Open=false vergessen, 2) bei laufendem Server bearbeitet, Änderung überschrieben, 3) Open=false gesetzt, aber nicht neu gestartet.

FAQ

Kann ich Whitelist mit Steam-only Servern nutzen? Ja — Durchsetzung passiert auf username-Ebene.

Verhindert Whitelist die Notwendigkeit für IP-Bans? Nein — sie sind komplementär.

Kann ich eine Steam-Gruppe whitelisten? Nicht in Vanilla.

Whitelist auf einem Project Zomboid-Server einrichten