H
HytaleAdminAPI v1.0.0
Zurück

Items

Base: /api/items

Spieler-Inventar verwalten und Items geben

Handler: ItemHandler
GET /api/items/{player}

Inventar anzeigen

Zeigt das Inventar eines Spielers.

Parameter

Name Typ Pflicht Beschreibung
player string Ja Spielername

Antwort-Beispiel

{"player":"Steve","inventory":[{"slot":0,"item":"diamond_sword","amount":1,"durability":100},{"slot":1,"item":"golden_apple","amount":5}]}

cURL

curl http://localhost:5550/api/items/Steve
POST /api/items/{player}/give

Item geben

Gibt einem Spieler ein Item.

Parameter

Name Typ Pflicht Beschreibung
player string Ja Spielername

Request Body

Feld Typ Pflicht Beschreibung
item string Ja Item-ID (z.B. "diamond_sword")
amount integer Nein Anzahl (Standard: 1)

Antwort-Beispiel

{"success":true,"message":"Gave Steve 5x golden_apple"}

cURL

curl -X POST http://localhost:5550/api/items/Steve/give \
  -H 'Content-Type: application/json' \
  -d '{"item":"golden_apple","amount":5}'
POST /api/items/{player}/clear

Inventar leeren

Leert das Inventar eines Spielers.

Parameter

Name Typ Pflicht Beschreibung
player string Ja Spielername

Antwort-Beispiel

{"success":true,"message":"Inventory of Steve cleared"}

cURL

curl -X POST http://localhost:5550/api/items/Steve/clear
Achtung: Diese Aktion kann nicht rückgängig gemacht werden!