MU Compass

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.

Agrega un botón de voto

Elige un estilo y pega el código en tu sitio web. Reemplaza “your-server” por la dirección de tu ficha: en el panel de dueño encontrarás el código listo con tu propia dirección.

Botón

Un botón color brasa “Vota en MU Compass”.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=button" alt="Vota por nosotros en MU Compass">
</a>

Insignia de puesto

Muestra tu puesto mensual actual.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=badge" alt="Vota por nosotros en MU Compass">
</a>

Mini banner

Un botón clásico de 88 × 31 para filas de enlaces.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=mini" alt="Vota por nosotros en MU Compass">
</a>

Recompensa 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ó.