Para dueños de servidores
Botón de voto y callback.
Pon un botón de voto en tu sitio web para que los jugadores voten con un clic, y luego recompénsalos in-game con un callback firmado.
Enlace de voto simple
¿Prefieres tu propio botón? Enlaza a los jugadores directo a tu página de votación. Funciona en cualquier navegador y en el celular.
Enlace de voto
https://mucompass.com/vote/your-serverRecompensa a los jugadores con el callback
Activa “Recompensa in-game a los jugadores cuando votan” en tu ficha y escribe tu URL de callback. Después de cada voto con nombre de personaje, MU Compass envía una petición POST con un cuerpo JSON a esa URL.
La firma es un HMAC-SHA256 en hexadecimal de un objeto JSON con solo los campos server, character y votedAt —en ese orden y sin espacios—, usando como clave el secreto del callback de tu ficha.
Cuerpo del callback
Se envía como application/json.
{
"server": "ember-realm",
"character": "DarkKnight77",
"votedAt": "2026-10-25T21:42:00.000Z",
"signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}Verifica la firma
Verifica siempre la firma antes de entregar una recompensa, y da a cada jugador como máximo una recompensa cada 12 horas. Aquí tienes un ejemplo para un servidor Node.js escrito en 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 y reintentos
- Responde con cualquier estado 2xx en menos de 5 segundos.
- Si tu servidor no responde o devuelve un error, lo intentamos de nuevo hasta 3 veces.
- Los votos sin nombre de personaje no se envían y aparecen como “Omitido”.
- Cada intento aparece en Votos recientes de tu panel como Entregado, Omitido o Falló.