Warps
Base: /api/warps
Teleportationspunkte verwalten (erstellen, auflisten, löschen, teleportieren)
Verarbeitung: WarpHandler
Endpunkte
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