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.
Link di voto semplice
Preferisci un pulsante tuo? Manda i giocatori direttamente alla tua pagina di voto. Funziona in ogni browser e su mobile.
Link di voto
https://mucompass.com/vote/your-serverPremia 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.