Spieler

Base: /api/players

Online-Spieler verwalten, Informationen abrufen, kicken, teleportieren

Verarbeitung: PlayersHandler

Endpunkte

GET /api/players Spieler auflisten GET /api/players/{name} Spieler-Details POST /api/players/{name}/kick Spieler kicken POST /api/players/{name}/teleport Spieler teleportieren POST /api/players/{name}/gamemode Spielmodus ändern

GET /api/players

Spieler auflisten

Liste aller aktuell online Spieler mit Details.

Antwort-Beispiel

[{"name":"Steve","uuid":"550e8400-e29b-41d4-a716-446655440000","health":20,"position":{"x":100.5,"y":64.0,"z":-200.3},"world":"overworld","gamemode":"survival","ping":45}]

cURL

curl http://localhost:5550/api/players

Internes Verhalten

Iteriert über alle online Spieler-Objekte des Servers.

GET /api/players/{name}

Spieler-Details

Detaillierte Informationen zu einem bestimmten Spieler.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Spielername

Antwort-Beispiel

{"name":"Steve","uuid":"550e8400-e29b-41d4-a716-446655440000","health":20,"max_health":20,"food":18,"level":15,"exp":0.5,"position":{"x":100.5,"y":64.0,"z":-200.3},"world":"overworld","gamemode":"survival","ping":45,"ip":"192.168.1.10","is_op":false}

cURL

curl http://localhost:5550/api/players/Steve

POST /api/players/{name}/kick

Spieler kicken

Entfernt einen Spieler vom Server.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Spielername

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`reason`	string	Nein	Kick-Grund (wird dem Spieler angezeigt)

Antwort-Beispiel

{"success":true,"message":"Player Steve has been kicked"}

cURL

curl -X POST http://localhost:5550/api/players/Steve/kick \
  -H 'Content-Type: application/json' \
  -d '{"reason":"Regelverstoß"}'

Internes Verhalten

Ruft player.kick(reason) auf dem Server-Thread auf.
Der Spieler sieht den Grund im Disconnect-Screen.

POST /api/players/{name}/teleport

Spieler teleportieren

Teleportiert einen Spieler zu bestimmten Koordinaten.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Spielername

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`x`	number	Ja	X-Koordinate
`y`	number	Ja	Y-Koordinate
`z`	number	Ja	Z-Koordinate
`world`	string	Nein	Ziel-Welt (Standard: aktuelle Welt)

Antwort-Beispiel

{"success":true,"message":"Player Steve teleported to 100.0, 64.0, -200.0"}

cURL

curl -X POST http://localhost:5550/api/players/Steve/teleport \
  -H 'Content-Type: application/json' \
  -d '{"x":100,"y":64,"z":-200}'

Internes Verhalten

Teleportation wird auf dem Server-Hauptthread ausgeführt (Thread-Safe).

POST /api/players/{name}/gamemode

Spielmodus ändern

Ändert den Spielmodus eines Spielers.

Parameter

Name	Typ	Pflicht	Beschreibung
`name`	string	Ja	Spielername

Anfragekörper

Feld	Typ	Pflicht	Beschreibung
`mode`	string	Ja	Spielmodus: survival, creative, adventure, spectator

Antwort-Beispiel

{"success":true,"message":"Gamemode of Steve set to creative"}

cURL

curl -X POST http://localhost:5550/api/players/Steve/gamemode \
  -H 'Content-Type: application/json' \
  -d '{"mode":"creative"}'