Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

GET /players/{uuid} #1

Open
acrylic-style opened this issue Jul 10, 2022 · 0 comments
Open

GET /players/{uuid} #1

acrylic-style opened this issue Jul 10, 2022 · 0 comments
Labels
enhancement New feature or request

Comments

@acrylic-style
Copy link
Member

acrylic-style commented Jul 10, 2022

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.

@acrylic-style acrylic-style added the enhancement New feature or request label Jul 10, 2022
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

1 participant