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

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/bedwars/stats/{player}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

204

200

{
  "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
    }
  }
}

The player has stats in that season.

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

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/bedwars/stats/{player}/all' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

204

200

{
  "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
    }
  }
}

The player has BedWars stats.

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

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/bedwars/top' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

{
  "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
        }
      }
    ]
  }
}

OK

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

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/bedwars/stats' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

{
  "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
  }
}

OK

These stats will update every 10 seconds.

Current season

get

Returns the current Minesweeper season.

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/bedwars/season'

200

200

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

OK

These stats will update every 10 seconds.

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