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!