Warps — API Doku

Warps

Base: /api/warps

Teleportationspunkte verwalten (erstellen, auflisten, löschen, teleportieren)

Verarbeitung: WarpHandler
GET /api/warps

Warps auflisten

Liste aller gespeicherten Warp-Punkte.

Antwort-Beispiel

[{"name":"spawn","x":0.0,"y":64.0,"z":0.0,"world":"overworld","created_by":"Admin"},{"name":"arena","x":500.0,"y":70.0,"z":-100.0,"world":"overworld","created_by":"Admin"}]

cURL

curl http://localhost:5550/api/warps
POST /api/warps/create

Warp erstellen

Erstellt einen neuen Warp-Punkt.

Anfragekörper

Feld Typ Pflicht Beschreibung
name string Ja Name des Warps
x number Ja X-Koordinate
y number Ja Y-Koordinate
z number Ja Z-Koordinate
world string Nein Welt (Standard: overworld)

Antwort-Beispiel

{"success":true,"message":"Warp arena created"}

cURL

curl -X POST http://localhost:5550/api/warps/create \
  -H 'Content-Type: application/json' \
  -d '{"name":"arena","x":500,"y":70,"z":-100}'

Internes Verhalten

Warp wird sofort in data/warps.json gespeichert.
DELETE /api/warps/{name}

Warp löschen

Löscht einen Warp-Punkt.

Parameter

Name Typ Pflicht Beschreibung
name string Ja Warp-Name

Antwort-Beispiel

{"success":true,"message":"Warp arena deleted"}

cURL

curl -X DELETE http://localhost:5550/api/warps/arena
POST /api/warps/{name}/teleport/{player}

Spieler zum Warp teleportieren

Teleportiert einen Spieler zu einem Warp-Punkt.

Parameter

Name Typ Pflicht Beschreibung
name string Ja Warp-Name
player string Ja Spielername

Antwort-Beispiel

{"success":true,"message":"Player Steve teleported to warp spawn"}

cURL

curl -X POST http://localhost:5550/api/warps/spawn/teleport/Steve