Deaths
Base: /api/deaths
View player deaths and causes of death
Handler: DeathHandler
GET
/api/deaths
List Deaths
List of all recorded deaths.
Response Example
[{"player":"Steve","cause":"fall","message":"Steve fell from a high place","position":{"x":100,"y":64,"z":-200},"world":"overworld","timestamp":"2025-01-15T14:30:00Z"}]cURL
curl http://localhost:5550/api/deaths
GET
/api/deaths/{player}
Player Deaths
Deaths of a specific player.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
player
|
string | Yes | Player name |
Response Example
{"player":"Steve","total_deaths":5,"deaths":[{"cause":"fall","message":"Steve fell from a high place","timestamp":"2025-01-15T14:30:00Z"}]}cURL
curl http://localhost:5550/api/deaths/Steve
GET
/api/deaths/stats
Death Statistics
Analysis of the most common causes of death.
Response Example
{"total":150,"by_cause":{"fall":45,"mob":38,"pvp":27,"lava":20,"drown":12,"other":8},"most_deaths_player":{"name":"Steve","deaths":23}}cURL
curl http://localhost:5550/api/deaths/stats