Common Questions

This page aims to answer some common questions users have about the Hypixel PublicAPI.

Table of Contents

1. How do I get a player's rank prefix?

How do I get a player's rank prefix?

ie [HELPER], [OWNER], [YOUTUBER], [VIP+], etc

In the player endpoint, a player's rank is actually split up across 5 different fields. When displaying a player's rank, these fields take precedence in the following order:

1. player.prefix - If this field is set, its value overrides the player's normal rank prefix
   1. ie A prefix of §c[OWNER] overrides the default ADMIN prefix
2. player.rank - The player's special rank
   1. ADMIN, MODERATOR, HELPER or YOUTUBER
3. player.monthlyPackageRank - The player's subscription-based rank
   1. Currently only SUPERSTAR for MVP++ players
4. player.newPackageRank - The player's post-EULA lifetime rank
   1. VIP, VIP_PLUS, MVP or MVP_PLUS
5. player.packageRank - The player's pre-EULA lifetime rank
   1. Same values as player.newPackageRank
   2. Pre-eula ranks give players who bought ranks before August 1st 2014 certain ingame advantages that are no longer sold with ranks (like coin boosters, kits, etc)

NOTE:
If any of the above fields have the value NONE or NORMAL, they should be treated as if they didn't exist. The only exception is prefix, which should always be displayed literally.

Other Rank-Related Fields

• player.monthlyRankColor - For players with MVP++, this determines whether they have an AQUA tag or the normal GOLD tag
  • If this field is not present, defaults to GOLD
• player.rankPlusColor - For players with MVP+ or MVP++, this determines what color their +s are
  • This field should contain the capitalized version of a Minecraft color's name. For all possible values, see this table.
  • If this field is not present, defaults to RED
• player.mostRecentMonthlyPackageRank - The player's most recent subscription-based rank
  • If this field is present, it means that the user has had the MVP++ rank before
  • If this field is present, it should only ever contain SUPERSTAR as of now
• player.buildTeam - Whether or not a player is on the Hypixel Build Team
  player.buildTeamAdmin - Whether or not the player is an administrator on the Hypixel Build Team
  • Both are likely only used for avatar frames on the forums
  • If either of these fields are not present, they default to false

TODO

• How do I convert numbers to dates?
• How do I check if a player is online?
• How do I calculate network level?
• How do I calculate guild level?