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
200
The player has stats in that mode.
*/*
get
GET /api/v1/fastbuilder/{mode}/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": {
      "games": 1,
      "wins": 1,
      "blocks": 1,
      "timeBest": 1,
      "timeTotal": 1,
      "confirmed": true,
      "speedrunConfirmed": true
    }
  }
}

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
200
OK
*/*
get
GET /api/v1/fastbuilder/{mode}/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": {
          "games": 1,
          "wins": 1,
          "blocks": 1,
          "timeBest": 1,
          "timeTotal": 1,
          "confirmed": true,
          "speedrunConfirmed": true
        }
      }
    ]
  }
}

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
200
OK
*/*
get
GET /api/v1/fastbuilder/stats HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

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

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
200
The player has FastBuilder stats.
*/*
get
GET /api/v1/fastbuilder/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": {
      "games": 1,
      "wins": 1,
      "blocks": 1
    }
  }
}

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
200
OK
*/*
get
GET /api/v1/fastbuilder/{mode}/stats HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

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

These stats will update every 10 seconds.

List of modes

get

Returns a list of all FastBuilder modes.

Responses
200
OK
*/*
get
GET /api/v1/fastbuilder/modes HTTP/1.1
Host: mcplayhd.net
Accept: */*
200

OK

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

Last updated

Was this helpful?