MU Compass

Per i proprietari

Pulsante di voto e callback.

Metti un pulsante di voto sul tuo sito così i giocatori possono votare con un clic, poi premiali in gioco con un callback firmato.

Aggiungi un pulsante di voto

Scegli uno stile e incolla il codice sul tuo sito. Sostituisci “your-server” con l'indirizzo della tua scheda — trovi il codice pronto con il tuo indirizzo nella dashboard del proprietario.

Pulsante

Un pulsante color brace “Vota su MU Compass”.

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

Badge posizione

Mostra la tua posizione mensile attuale.

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

Mini banner

Un classico pulsante 88 × 31 per le file di link.

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

Premia i giocatori con il callback

Attiva “Premia i giocatori in gioco quando votano” nella tua scheda e inserisci l'URL di callback. Dopo ogni voto con un nome di personaggio, MU Compass invia a quell'URL una richiesta POST con un corpo JSON.

La firma è un HMAC-SHA256 esadecimale di un oggetto JSON con solo i campi server, character e votedAt — in quest'ordine e senza spazi — usando come chiave il segreto del callback della tua scheda.

Corpo del callback

Inviato come application/json.

{
  "server": "ember-realm",
  "character": "DarkKnight77",
  "votedAt": "2026-10-25T21:42:00.000Z",
  "signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}

Verifica la firma

Verifica sempre la firma prima di dare un premio e dai a ogni giocatore al massimo un premio ogni 12 ore. Ecco un esempio per un server Node.js scritto 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));
}

Consegna e nuovi tentativi

  • Rispondi con uno stato 2xx qualsiasi entro 5 secondi.
  • Se il tuo server non risponde o restituisce un errore, riproviamo fino a 3 volte.
  • I voti senza nome del personaggio non vengono inviati e risultano come “Saltato”.
  • Ogni tentativo è elencato in Voti recenti nella tua dashboard come Consegnato, Saltato o Fallito.