Nexus Tiers API Documentation

Gamemode Tier Endpoint

Fetch a player's tier for a specific gamemode. Perfect for rendering prefixes or badges in Minecraft clients (like Tier Tagger).

GET /api/:gamemode/:username

Parameter	Description
:gamemode	The internal key of the gamemode (e.g. `vanilla`, `sword`, `smp`)
:username	The exact Minecraft username of the player

Example Request: https://nexus-tiers.com/api/vanilla/SoulFiredMc

[
  {
    "uuid": "116d91a9-07f3-448b-8243-08a45dc82968",
    "name": "SoulFiredMc",
    "region": "NA",
    "points": 4,
    "rankings": {
      "vanilla": {
        "tier": "HT5",
        "peak_tier": "HT5",
        "attained": 1715421200000,
        "retired": false
      }
    }
  }
]

Overall Tiers Endpoint

Fetch all gamemode tiers for a player in a single request. Use the special overall keyword in place of a gamemode.

GET /api/overall/:username

Example Request: https://nexus-tiers.com/api/overall/SoulFiredMc

[
  {
    "uuid": "116d91a9-07f3-448b-8243-08a45dc82968",
    "name": "SoulFiredMc",
    "region": "NA",
    "points": 6,
    "rankings": {
      "sword": {
        "tier": "HT5",
        "peak_tier": "HT5",
        "attained": 1715421200000,
        "retired": false
      },
      "smp": {
        "tier": "LT5",
        "peak_tier": "LT5",
        "attained": 1715421200000,
        "retired": false
      }
    }
  }
]

Minecraft Mod Integration

If you are using a mod like Tier Tagger or writing a custom Fabric/Forge client, you can use these endpoints to dynamically fetch tags when a player joins the server.

// Example Java HTTP Request (Fabric)
String url = "https://nexus-tiers.com/api/sword/" + targetPlayerName;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
JsonObject json = JsonParser.parseString(response.body()).getAsJsonObject();

String tier = json.get("tier").getAsString();
if (!tier.equals("none")) {
    // Apply the tier tag to the player's nametag!
}