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

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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.

*/*

204

The player doesn't have stats in that mode.

*/*

get

/fastbuilder/{mode}/stats/{player}

HTTPcURLJavaScriptPython

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

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

modestringRequired

mode to get the top list of

Query parameters

tokenstringOptional

deprecated

Responses

200

OK

*/*

get

/fastbuilder/{mode}/top

HTTPcURLJavaScriptPython

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

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

tokenstringOptional

deprecated

Responses

200

OK

*/*

get

/fastbuilder/stats

HTTPcURLJavaScriptPython

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

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

playerstringRequired

name or uuid of the player

Query parameters

tokenstringOptional

deprecated

Responses

200

The player has FastBuilder stats.

*/*

204

The player doesn't have FastBuilder stats.

*/*

get

/fastbuilder/stats/{player}

HTTPcURLJavaScriptPython

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

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

Bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

modestringRequired

mode to get the stats of

Query parameters

tokenstringOptional

deprecated

Responses

200

OK

*/*

get

/fastbuilder/{mode}/stats

HTTPcURLJavaScriptPython

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

/fastbuilder/modes

HTTPcURLJavaScriptPython

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

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