McPlayHD.net
  • Public API Documentation
  • Information
    • Getting Started
    • Changelog
  • Stats
    • FastBuilder
    • BedWars
    • Minesweeper
  • Player
    • Player Info
  • Objectives
    • Daily
Powered by GitBook
On this page

Was this helpful?

  1. Objectives

Daily

Requesting info and stats for daily objectives

PreviousPlayer Info

Last updated 3 years ago

Was this helpful?

Daily objective info

get

Returns the currently highlighted category and the next reset time.

Authorizations
Responses
200
OK
*/*
get
GET /api/v1/objectives/daily/info HTTP/1.1
Host: mcplayhd.net
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

OK

{
  "status": 1,
  "path": "text",
  "timeStamp": "text",
  "processingTime": 1,
  "data": {
    "highlightedCategory": "BEDWARS",
    "objectivesCompleted": 1,
    "nextResetTime": "2025-06-13T18:50:42.274Z"
  }
}

Daily objective info of player

get

Returns the current daily objective of a player and it's progress.

Authorizations
Path parameters
playerstringRequired

name or uuid of the player

Query parameters
languagestringOptional

language to display description in

Responses
200
The player has an active objective.
*/*
204
The player hasn't joined yet today or the plugins aren't in sync.
*/*
get
GET /api/v1/objectives/daily/{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"
    },
    "data": {
      "objective": "BW_PLAY",
      "description": "text",
      "required": 1,
      "counter": 1,
      "rewardsCollected": true
    }
  }
}

Daily objective stats of player

get

Returns the daily objective stats of a player.

Authorizations
Path parameters
playerstringRequired

name or uuid of the player

Responses
200
The player has daily objective stats.
*/*
204
The player has never finished any daily objective.
*/*
get
GET /api/v1/objectives/daily/{player}/stats 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": {
      "total": 1,
      "streak": 1,
      "bestStreak": 1,
      "lastFinished": "2025-06-13T18:50:42.274Z"
    }
  }
}

Daily objective streaks

get

Returns all stats of players with an active streak ordered by the streak duration and completion time.

Authorizations
Responses
200
OK
*/*
get
GET /api/v1/objectives/daily/streaks 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": {
          "total": 1,
          "streak": 1,
          "bestStreak": 1,
          "lastFinished": "2025-06-13T18:50:42.274Z"
        }
      }
    ]
  }
}
  • GETDaily objective info
  • GETDaily objective info of player
  • GETDaily objective stats of player
  • GETDaily objective streaks