Farbthema

Whitelist

Base: /api/whitelist

Spieler per Name oder UUID freigeben, auch vor dem ersten Besuch

Verarbeitung: WhitelistHandler
GET /api/whitelist

Whitelist abrufen

Liefert, ob die Whitelist aktiv ist, und alle Einträge.

Antwort-Beispiel

[
  {
    "uuid": "1234...",
    "name": "Steve"
  }
]

cURL

curl -X GET 'http://localhost:5550/api/whitelist' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Liest whitelist.json.
POST /api/whitelist

Zur Whitelist hinzufügen

Trägt einen Spieler ein. Unbekannte Namen löst Hytales whitelist-Befehl auf; Erfolg nur bei Bestätigung durch Hytale.

Anfragekörper

Feld Typ Pflicht Beschreibung
name string Nein Spielername (name oder uuid nötig)
uuid string Nein Spieler-UUID

Antwort-Beispiel

{
  "success": true,
  "uuid": "1234...",
  "name": "Steve"
}

cURL

curl -X POST 'http://localhost:5550/api/whitelist' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name": "NewPlayer"}'

Internes Verhalten

Schreibt whitelist.json oder führt whitelist add <Name> aus.
DELETE /api/whitelist/{name}

Von der Whitelist entfernen

Entfernt einen Spieler von der Whitelist.

Parameter

Name Typ Pflicht Beschreibung
name string Ja Spielername oder UUID (URL-kodiert)

Antwort-Beispiel

{
  "success": true,
  "player": "Steve"
}

cURL

curl -X DELETE 'http://localhost:5550/api/whitelist/Eranio' \
  -H 'X-Admin-Token: YOUR_TOKEN'

Internes Verhalten

Schreibt whitelist.json.