FastBuilder

Requesting FastBuilder stats

Last updated 2 years ago

Was this helpful?

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

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

get

GET /api/v1/fastbuilder/{mode}/top HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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

Global stats

get

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

Authorizations

Query parameters

tokenstringOptional

deprecated

Responses

get

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

200

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

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

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

get

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

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

List of modes

get

Returns a list of all FastBuilder modes.

Responses

get

GET /api/v1/fastbuilder/modes HTTP/1.1
Host: mcplayhd.net
Accept: */*

200

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