Whitelist einrichten – So schützt du deinen Server

Eine Whitelist ist eine Liste von Spielern, die als einzige deinem Server beitreten dürfen. Alle anderen werden automatisch abgewiesen. Diese Anleitung zeigt dir, wie du eine Whitelist für verschiedene Spiele einrichtest – von Minecraft über FiveM bis ARK.

Hinweis: Ausführliche Unterseiten zu Bans und Server-Sicherheit findest du in der linken Navigation.

Was ist eine Whitelist?

Eine Whitelist ist das Gegenteil einer Blacklist (Ban-Liste). Statt bestimmte Spieler auszuschließen, erlaubst du nur bestimmten Spielern den Zugang. Alle anderen werden automatisch abgewiesen. Das ist die sicherste Methode, um deinen Server privat zu halten.

Wann ist eine Whitelist sinnvoll?

• Private Server für Freunde oder Communities
• Server in der Testphase – nur Tester dürfen drauf
• Content-Creator-Server – nur ausgewählte Spieler
• Schutz vor Griefing und unerwünschten Gästen
• RP-Server mit Bewerbungsprozess – nur angenommene Spieler

Minecraft Whitelist

Per Konsole (während der Server läuft)

# Whitelist aktivieren
whitelist on

# Spieler hinzufügen
whitelist add Spielername

# Spieler entfernen
whitelist remove Spielername

# Alle Spieler auf der Whitelist anzeigen
whitelist list

# Whitelist deaktivieren
whitelist off

# Whitelist neu laden (nach manuellen Änderungen an der Datei)
whitelist reload

Per whitelist.json (Server muss aus sein)

Die Whitelist wird in der Datei whitelist.json im Server-Verzeichnis gespeichert:

[
    {
        "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "name": "Spieler1"
    },
    {
        "uuid": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
        "name": "Spieler2"
    }
]

Du kannst diese Datei direkt bearbeiten. Die UUID eines Spielers findest du auf Seiten wie mcuuid.net.

Per server.properties (bei Serverstart)

# In server.properties
white-list=true
enforce-whitelist=true

enforce-whitelist=true kickt alle Spieler, die nicht auf der Whitelist stehen, sofort vom Server.

FiveM Whitelist

FiveM hat keine eingebaute Whitelist. Die meisten Server nutzen dafür ihr Framework:

Mit QBCore

1. Öffne die server.cfg
2. Stelle sicher, dass QBCore geladen wird
3. In der Datenbank-Tabelle players gibt es eine Spalte für den Whitelist-Status
4. Setze Spieler auf "whitelisted" in der Datenbank:

   UPDATE players SET whitelist = 1 WHERE citizenid = 'ABC123';

Mit einfachem Lua-Script

Erstelle eine whitelist.lua in deinem Ressourcen-Ordner:

local Whitelist = {
    "license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "license:yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
}

AddEventHandler('playerConnecting', function(name, setKickReason, deferrals)
    local license = GetPlayerIdentifierByType(source, 'license')

    deferrals.defer()
    deferrals.update('Prüfe Whitelist...')

    for _, id in ipairs(Whitelist) do
        if id == license then
            deferrals.done()
            return
        end
    end

    deferrals.done('Du stehst nicht auf der Whitelist.\nBewirb dich auf unserem Discord: discord.gg/deinlink')
end)

ARK Whitelist

Per GameUserSettings.ini

# In ShooterGame/Saved/Config/WindowsServer/GameUserSettings.ini

[ServerSettings]
bWhitelist=true
WhitelistFile=whitelist.txt

whitelist.txt erstellen

Erstelle die Datei im Ordner ShooterGame/Saved/:

# Ein Steam64-ID pro Zeile
76561198012345678
76561198087654321

Die Steam64-ID findest du auf Seiten wie steamid.io oder indem du im Spiel die Konsole öffnest und ShowMyAdminManager eingibst.

CS2 Whitelist

CS2 hat keine native Whitelist, aber du kannst sie mit einem Passwort und dem Reserved-Slots-System simulieren:

Per server.cfg

# Passwort setzen
sv_password "mein_geheimes_passwort"

# Reservierte Slots für bestimmte Spieler (per SteamID)
sv_reservation_file "reserved_slots.txt"

reserved_slots.txt

STEAM_0:1:12345678
STEAM_0:1:87654321

Allgemeine Tipps für Whitelists

• Backup machen: Sichere deine Whitelist-Datei regelmäßig
• Bewerbungsprozess: Für größere Server lohnt sich ein automatisiertes System (Discord-Bot, Webformular)
• Whitelist testen: Lass einen Freund versuchen beizutreten, der nicht auf der Liste steht
• Dokumentieren: Notiere dir, wann und warum du Spieler hinzugefügt hast

Häufige Probleme

Whitelist funktioniert nicht (Minecraft):

• Prüfe mit whitelist list ob der Spieler korrekt eingetragen ist
• Server nach Änderungen an der whitelist.json neustarten oder whitelist reload ausführen
• OPs umgehen standardmäßig die Whitelist – in server.properties: enforce-whitelist=true setzen

Spieler wird nicht erkannt (FiveM):

• Die License ändert sich, wenn der Spieler FiveM neu installiert
• Besser: Steam-Identifier oder Discord-ID als Whitelist-Kriterium nutzen

ARK Whitelist greift nicht:

• Server nach Änderungen an der whitelist.txt neustarten
• Datei muss im richtigen Ordner liegen: ShooterGame/Saved/

Passende Anleitungen

• FiveM installieren
• FiveM optimieren
• Crashes verhindern
• FPS Drops beheben
• FiveM Hub

Server bei NexoraHost: nexorahost.com