MU Compass

For server owners

Vote button & callback.

Put a vote button on your website so players can vote in one click, then reward them in game with a signed callback.

Add a vote button

Pick a style and paste the code on your website. Replace “your-server” with the address of your listing — you will find the ready-made code with your own address in the owner dashboard.

Button

An ember “Vote on MU Compass” button.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=button" alt="Vote for us on MU Compass">
</a>

Rank badge

Shows your current monthly rank.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=badge" alt="Vote for us on MU Compass">
</a>

Mini banner

A classic 88 × 31 button for link rows.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=mini" alt="Vote for us on MU Compass">
</a>

Reward players with the callback

Turn on “Reward players in-game when they vote” in your listing and enter your callback URL. After every vote with a character name, MU Compass sends a POST request with a JSON body to that URL.

The signature is a hex HMAC-SHA256 of a JSON object with only the server, character and votedAt fields — in that order and without spaces — using the callback secret of your listing as the key.

Callback body

Sent as application/json.

{
  "server": "ember-realm",
  "character": "DarkKnight77",
  "votedAt": "2026-10-25T21:42:00.000Z",
  "signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}

Verify the signature

Always verify the signature before giving a reward, and give each player at most one reward per 12 hours. Here is an example for a Node.js server written in TypeScript.

verify-vote.ts

import { createHmac, timingSafeEqual } from "node:crypto";

type VotePayload = {
  server: string;
  character: string;
  votedAt: string;
  signature: string;
};

export function isValidVote(payload: VotePayload, secret: string) {
  const body = JSON.stringify({
    server: payload.server,
    character: payload.character,
    votedAt: payload.votedAt,
  });
  const expected = createHmac("sha256", secret).update(body).digest("hex");
  const received = payload.signature;
  return expected.length === received.length && timingSafeEqual(Buffer.from(expected), Buffer.from(received));
}

Delivery and retries

  • Answer with any 2xx status within 5 seconds.
  • If your server does not answer or returns an error, we try again up to 3 times.
  • Votes without a character name are not sent and show as “Skipped”.
  • Every attempt is listed under Recent votes in your dashboard as Delivered, Skipped or Failed.