Skip to content

GET /players/{uuid} #1

@acrylic-style

Description

@acrylic-style
GET /players/1865ab8c-700b-478b-9b52-a8c58739df1a

would return 200 OK:

{
  "uuid": "1865ab8c-700b-478b-9b52-a8c58739df1a",
  "name": "KotlinLove", // username stored in database, not mojang
  "groups": [
    // sorted by weight (first element is their highest group)
    // some non-public groups (such as switchdeveloper and punishment related groups) may be excluded from this list
    // Sara (such as 100yen) is also included in this list, but groups of lower prices may or may not be missing. Highest sara is always included.
    "developer"
  ],
  "servers": {
    "life": {
      "admin": false,
      "moderator": false, // moderator and builder can be true at same time
      "builder": false,
      "rank": 7, // number of > 0
      // these balance values might be negative in rare cases
      "balance": 16256025.26, // result is equal to raw_balance + raw_offline_balance
      "raw_balance": 16256025.26,
      "raw_offline_balance": 0.0, // the balance which is still yet to be applied
      "total_play_time": 91219 // in minutes, same as tsl.total_play_time
    },
    "tsl": {
      "admin": false,
      "moderator": false,
      "builder": false,
      "total_play_time": 91219 // in minutes, same as life.total_play_time
    },
    "lgw": {
      "admin": false,
      "moderator": false,
      "builder": false,
      "vip": false
    },
    "despawn": {
      "admin": false,
      "moderator": false,
      "builder": false
    },
    "diverse": {
      "admin": false,
      "moderator": false,
      "builder": false
      // exp, money, veteranpoint, title might be added in the future
    },
    "vanilife": {
      "admin": false,
      "moderator": false,
      "builder": false
    }
  }
}

GET /players/bbd2e5c9-a232-3cc3-96b3-eba47c24f841

would return 400 Bad Request:

{
  "error": "cannot get player from offline (version 3) UUID"
}

Note: version 0 (used for accounts of Bedrock Edition) UUIDs should be allowed.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions