Para donos de servidor
Botão de voto e callback.
Coloque um botão de voto no seu site para os jogadores votarem com um clique e recompense-os no jogo com um callback assinado.
Link de voto simples
Prefere seu próprio botão? Mande os jogadores direto para a sua página de voto. Funciona em qualquer navegador e no celular.
Link de voto
https://mucompass.com/vote/your-serverRecompense os jogadores com o callback
Ative “Recompensar os jogadores no jogo quando votarem” na sua listagem e informe a URL de callback. Depois de cada voto com nome de personagem, o MU Compass envia uma requisição POST com um corpo JSON para essa URL.
A assinatura é um HMAC-SHA256 em hexadecimal de um objeto JSON só com os campos server, character e votedAt — nessa ordem e sem espaços — usando o segredo do callback da sua listagem como chave.
Corpo do callback
Enviado como application/json.
{
"server": "ember-realm",
"character": "DarkKnight77",
"votedAt": "2026-10-25T21:42:00.000Z",
"signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}Verifique a assinatura
Sempre verifique a assinatura antes de dar uma recompensa e dê no máximo uma recompensa por jogador a cada 12 horas. Veja um exemplo para um servidor Node.js escrito em 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));
}Entrega e novas tentativas
- Responda com qualquer status 2xx em até 5 segundos.
- Se o seu servidor não responder ou retornar um erro, tentamos de novo até 3 vezes.
- Votos sem nome de personagem não são enviados e aparecem como “Ignorado”.
- Cada tentativa aparece em Votos recentes no seu painel como Entregue, Ignorado ou Falhou.