Items
Base: /api/items
Manage player inventory and give items
Handler: ItemHandler
GET
/api/items/{player}
Show Inventory
Shows a player's inventory.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
player
|
string | Yes | Player name |
Response Example
{"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
Give Item
Gives a player an item.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
player
|
string | Yes | Player name |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
item
|
string | Yes | Item ID (e.g. "diamond_sword") |
amount
|
integer | No | Amount (default: 1) |
Response Example
{"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
Clear Inventory
Clears a player's inventory.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
player
|
string | Yes | Player name |
Response Example
{"success":true,"message":"Inventory of Steve cleared"}cURL
curl -X POST http://localhost:5550/api/items/Steve/clearWarning: This action cannot be undone!