MU Compass

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.

Adicione um botão de voto

Escolha um estilo e cole o código no seu site. Troque “your-server” pelo endereço da sua listagem — o código pronto com o seu próprio endereço está no painel do dono.

Botão

Um botão “Vote no MU Compass” na cor brasa.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=button" alt="Vote em nós no MU Compass">
</a>

Selo de posição

Mostra a sua posição atual no ranking mensal.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=badge" alt="Vote em nós no MU Compass">
</a>

Mini banner

Um botão clássico 88 × 31 para faixas de links.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=mini" alt="Vote em nós no MU Compass">
</a>

Recompense 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.