# Whitelist einrichten – So schützt du deinen Server

Whitelist einrichten – So schützt du deinen Server – Schritt-für-Schritt-Anleitung für deinen Fivem bei NexoraHost.

**Kurzantwort:** Server Schritt für Schritt einrichten – Voraussetzungen prüfen, Dateien installieren, Ports konfigurieren und Dienst starten.

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](https://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

    - Öffne die `server.cfg`
- Stelle sicher, dass QBCore geladen wird
- In der Datenbank-Tabelle `players` gibt es eine Spalte für den Whitelist-Status
- 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](https://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](/de/gameserver/fivem/installation)
- [FiveM optimieren](/de/gameserver/fivem/optimize)
- [Crashes verhindern](/de/gameserver/fivem/protecting-your-server-from-crashes)
- [FPS Drops beheben](/de/gameserver/fivem/performance-optimierung/fixing-fps-drop)
- [FiveM Hub](/de/gameserver/fivem)

*Server bei NexoraHost: [nexorahost.com](https://nexorahost.com)*