Bans

Base: /api/bans

Spieler-Bans verwalten (auflisten, hinzufügen, entfernen)

Handler: BanHandler

GET /api/bans

Ban-Liste

Liste aller gesperrten Spieler.

Antwort-Beispiel

[{"player":"Griefer123","reason":"Griefing","banned_by":"Admin","banned_at":"2025-01-15T10:30:00Z","expires":null}]

cURL

curl http://localhost:5550/api/bans

POST /api/bans/add

Spieler bannen

Bannt einen Spieler vom Server.

Request Body

Feld	Typ	Pflicht	Beschreibung
`player`	string	Ja	Spielername
`reason`	string	Nein	Ban-Grund
`duration`	string	Nein	Ban-Dauer (z.B. "7d", "24h", "permanent")

Antwort-Beispiel

{"success":true,"message":"Player Griefer123 has been banned"}

cURL

curl -X POST http://localhost:5550/api/bans/add \
  -H 'Content-Type: application/json' \
  -d '{"player":"Griefer123","reason":"Griefing","duration":"7d"}'

Internes Verhalten

Speichert Ban in data/bans.json.
Kickt den Spieler sofort wenn online.
Ban-Ablauf wird bei Login geprüft.

DELETE /api/bans/{player}

Ban aufheben

Hebt den Ban eines Spielers auf.

Parameter

Name	Typ	Pflicht	Beschreibung
`player`	string	Ja	Spielername

Antwort-Beispiel

{"success":true,"message":"Player Griefer123 has been unbanned"}

cURL

curl -X DELETE http://localhost:5550/api/bans/Griefer123