BedWars

Requesting BedWars stats

Stats of a player (and season)

get

Get the BedWars stats of a player by their UUID or name.

If you don't provide a specific season, the API will return the player's stats for the current season.

Authorizations

Path parameters

playerstringRequired

name or uuid of the player

Query parameters

seasonstringOptional

season number

Responses

200

The player has stats in that season.

*/*

204

The player doesn't have stats in that season.

*/*

get

HTTPcURLJavaScriptPython

GET /api/v1/bedwars/stats/{player} HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "playerInfo": {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "group": "PLAYER"
    },
    "stats": {
      "rank": 1,
      "points": 1,
      "kills": 1,
      "deaths": 1,
      "games": 1,
      "beds": 1,
      "wins": 1,
      "blocksPlaced": 1,
      "blocksDestroyed": 1,
      "bronzeCollected": 1,
      "silverCollected": 1,
      "goldCollected": 1,
      "itemsCollected": 1
    }
  }
}

Summed season stats of a player

get

Get the summed stats of all seasons of a player.

Authorizations

Path parameters

playerstringRequired

name or uuid of the player

Responses

200

The player has BedWars stats.

*/*

204

The player doesn't have any BedWars stats.

*/*

get

HTTPcURLJavaScriptPython

GET /api/v1/bedwars/stats/{player}/all HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "playerInfo": {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "group": "PLAYER"
    },
    "stats": {
      "kills": 1,
      "deaths": 1,
      "games": 1,
      "beds": 1,
      "wins": 1,
      "blocksPlaced": 1,
      "blocksDestroyed": 1,
      "bronzeCollected": 1,
      "silverCollected": 1,
      "goldCollected": 1,
      "itemsCollected": 1
    }
  }
}

Requesting "all" season stats of a player costs {season-1} rate requests.

Top stats (of season)

get

Returns a list of the top BedWars players of a certain season.

If you don't provide a specific season, the API will return the top stats for the current season.

Authorizations

Query parameters

seasonstringOptional

season number

Responses

200

OK

*/*

get

HTTPcURLJavaScriptPython

GET /api/v1/bedwars/top HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "top": [
      {
        "playerInfo": {
          "uuid": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "group": "PLAYER"
        },
        "stats": {
          "rank": 1,
          "points": 1,
          "kills": 1,
          "deaths": 1,
          "games": 1,
          "beds": 1,
          "wins": 1,
          "blocksPlaced": 1,
          "blocksDestroyed": 1,
          "bronzeCollected": 1,
          "silverCollected": 1,
          "goldCollected": 1,
          "itemsCollected": 1
        }
      }
    ]
  }
}

These stats will update every 10 seconds.

Global stats (of season)

get

Resturns the sums of all countable BedWars statistics.

If you don't provide a specific season, the API will return the sums of all seasons.

Authorizations

Query parameters

seasonstringOptional

season number

Responses

200

OK

*/*

get

HTTPcURLJavaScriptPython

GET /api/v1/bedwars/stats HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "kills": 1,
    "beds": 1,
    "blocksPlaced": 1,
    "blocksDestroyed": 1,
    "bronzeCollected": 1,
    "silverCollected": 1,
    "goldCollected": 1,
    "itemsCollected": 1
  }
}

These stats will update every 10 seconds.

Current season

get

Returns the current Minesweeper season.

Responses

200

OK

*/*

get

HTTPcURLJavaScriptPython

GET /api/v1/bedwars/season HTTP/1.1
Host: mcplayhd.net
Accept: */*

200

OK

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "season": 1
  }
}

These stats will update every 10 seconds.

This action costs 0 rate requests and doesn't require authentication.