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.
Plain vote link
Prefer your own button? Link players straight to your vote page. It works in every browser and on mobile.
Vote link
https://mucompass.com/vote/your-serverReward 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.