Warps

Base: /api/warps

Hytales eigene Warps, im Spiel mit /warp nutzbar

Verarbeitung: WarpsHandler

Endpunkte

GET /api/warps Warps auflisten POST /api/warps Warp anlegen POST /api/warps/{name}/tp Zum Warp teleportieren DELETE /api/warps/{name} Warp löschen

GET /api/warps

Warps auflisten

Liefert alle Warps mit Welt, Position, Blickrichtung und Ersteller, auch im Spiel angelegte.

Antwort-Beispiel

[
  {
    "name": "spawn",
    "world": "default",
    "x": 10.0,
    "y": 64.0,
    "z": -3.0,
    "yaw": 90.0,
    "creator": "Admin",
    "created": "2026-01-01T00:00:00Z",
    "world_loaded": true
  }
]

cURL

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

Internes Verhalten

Liest die Warp-Liste von TeleportPlugin.

POST /api/warps

Warp anlegen

Legt einen Warp an der Position eines Spielers oder an Koordinaten an.

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`name`	string	Ja	Warp-ID, 1 bis 32 Zeichen A-Z, a-z, 0-9, _ und -
`player`	string	Nein	Position und Blickrichtung dieses Online-Spielers verwenden
`world`	string	Nein	Welt für Koordinaten, Standard erste geladene Welt
`x`	number	Nein	Pflicht ohne player
`y`	number	Nein	Pflicht ohne player
`z`	number	Nein	Pflicht ohne player
`replace`	boolean	Nein	Bestehenden Warp überschreiben, Standard false
`creator`	string	Nein	Ersteller, Standard Panel

Antwort-Beispiel

{
  "success": true,
  "name": "spawn",
  "world": "default",
  "x": 10.0,
  "y": 64.0,
  "z": -3.0
}

cURL

curl -X POST 'http://localhost:5550/api/warps' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name": "spawn_hub", "player": "Eranio"}'

Internes Verhalten

Registriert den Warp bei TeleportPlugin und speichert dessen warps.json.

POST /api/warps/{name}/tp

Zum Warp teleportieren

Teleportiert einen Online-Spieler zum Warp, auch weltübergreifend.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Warp-ID

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`player`	string	Ja	Online-Spieler

Antwort-Beispiel

{
  "success": true,
  "player": "Steve",
  "warp": "spawn",
  "world": "default"
}

cURL

curl -X POST 'http://localhost:5550/api/warps/spawn_hub/tp' \
  -H 'X-Admin-Token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"player": "Eranio"}'

Internes Verhalten

Ergänzt den Teleport-Verlauf (/back) und setzt eine Teleport-Komponente.

DELETE /api/warps/{name}

Warp löschen

Entfernt einen Warp.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Warp-ID

Antwort-Beispiel

{
  "success": true,
  "name": "spawn"
}

cURL

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

Internes Verhalten

Entfernt ihn aus TeleportPlugin und speichert.