Mace SubModes

Public API

Free, read-only JSON for the same rankings the site and Discord bot use. No key needed.

https://msm.macepvp.site/api/v1OpenAPI spec

Players

  • GET/api/v1/players?search={name}

    Search profiles by username. Paginate with page and pageSize.

    Try it
  • GET/api/v1/players/{id}

    One player by username, Minecraft UUID, or internal ID, with every mode tier.

    Try it
  • GET/api/v1/players/{id}/rankings

    Just that player's rankings: current, peak, and retired tiers.

    Try it

Rankings

  • GET/api/v1/rankings/overall

    Overall leaderboard by total peak-tier points, with titles and regions.

    Try it
  • GET/api/v1/rankings/{kitId}

    One mode's leaderboard, ordered from HT1 down.

    Try it

Results & catalog

  • GET/api/v1/results/recent

    Latest finalized tests with the previous and new tier.

    Try it
  • GET/api/v1/kits

    Every mode with its icon and kit image.

    Try it
  • GET/api/v1/tiers

    Tiers in ranked order.

    Try it

Example

const response = await fetch("https://msm.macepvp.site/api/v1/rankings/overall?pageSize=10");
const { data } = await response.json();
for (const player of data) console.log(player.position, player.username, player.points);

Responses are paginated as { data, pagination }. Please cache results and keep requests reasonable.