FastBuilder

Requesting FastBuilder stats

Stats of a player and mode

get

Get the FastBuilder stats of a player by their UUID or name and a mode. All times are in Milliseconds. If you want to get the average time, you need to divide the totalTime by the wins.

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

Authorizations

Path parameters

modestringrequired

mode to get the stats of

playerstringrequired

name or uuid of the player

Query parameters

tokenstringoptional

deprecated

Responses

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/fastbuilder/{mode}/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": {
      "games": 1,
      "wins": 1,
      "blocks": 1,
      "timeBest": 1,
      "timeTotal": 1,
      "confirmed": true,
      "speedrunConfirmed": true
    }
  }
}

The player has stats in that mode.

Top stats of mode

get

Returns a list of the top FastBuilder players of a certain mode. All times are in Milliseconds. If you want to get the average time, you need to divide the totalTime by the wins.

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

Authorizations

Path parameters

modestringrequired

mode to get the top list of

Query parameters

tokenstringoptional

deprecated

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/fastbuilder/{mode}/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": {
          "games": 1,
          "wins": 1,
          "blocks": 1,
          "timeBest": 1,
          "timeTotal": 1,
          "confirmed": true,
          "speedrunConfirmed": true
        }
      }
    ]
  }
}

OK

These stats will update every 10 seconds.

Global stats

get

Resturns the sum of all games, wins and blocks placed in FastBuilder.

Authorizations

Query parameters

tokenstringoptional

deprecated

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

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

200

200

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "games": 1,
    "wins": 1,
    "blocks": 1
  }
}

OK

These stats will update every 10 seconds.

Global stats of player

get

Resturns the sum of all games, wins and blocks placed of a player in FastBuilder.

Authorizations

Path parameters

playerstringrequired

name or uuid of the player

Query parameters

tokenstringoptional

deprecated

Responses

*/*

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/fastbuilder/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": {
      "games": 1,
      "wins": 1,
      "blocks": 1
    }
  }
}

The player has FastBuilder stats.

This action costs 2 rate requests.

Global stats of mode

get

Resturns the sum of all games, wins and blocks placed in a certain FastBuilder mode. Additionally this page will return the max time that is manually confirmed by staff. You can also see the maximum number that will be shown in the leaderboard before switching to percentages. You will also find a distribution with all best times and how many players have reached given time.

Authorizations

Path parameters

modestringrequired

mode to get the stats of

Query parameters

tokenstringoptional

deprecated

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

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

200

200

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "sums": {
      "games": 1,
      "wins": 1,
      "blocks": 1
    },
    "maxConfirmedTime": 1,
    "leaderboardSize": 1,
    "distribution": {
      "ANY_ADDITIONAL_PROPERTY": 1
    }
  }
}

OK

These stats will update every 10 seconds.

List of modes

get

Returns a list of all FastBuilder modes.

Responses

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mcplayhd.net/api/v1/fastbuilder/modes'

200

200

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "modes": [
      "NORMAL"
    ]
  }
}

OK

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