MU Compass

Pentru proprietarii de servere

Buton de vot și callback.

Pune un buton de vot pe site-ul tău ca jucătorii să voteze dintr-un click, apoi recompensează-i în joc printr-un callback semnat.

Adaugă un buton de vot

Alege un stil și lipește codul pe site-ul tău. Înlocuiește „your-server” cu adresa listării tale — codul gata făcut, cu propria ta adresă, îl găsești în panoul proprietarului.

Buton

Un buton „Votează pe MU Compass” în culoarea jarului.

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

Insignă cu locul

Arată locul tău actual în clasamentul lunar.

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

Mini banner

Un buton clasic de 88 × 31 pentru rândurile de linkuri.

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

Recompensează jucătorii prin callback

Activează „Recompensează jucătorii în joc când votează” în listarea ta și introdu URL-ul de callback. După fiecare vot cu nume de personaj, MU Compass trimite o cerere POST cu un body JSON către acel URL.

Semnătura este un HMAC-SHA256 în hex al unui obiect JSON care conține doar câmpurile server, character și votedAt — în această ordine și fără spații — folosind drept cheie secretul de callback al listării tale.

Body-ul callback-ului

Trimis ca application/json.

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

Verifică semnătura

Verifică întotdeauna semnătura înainte de a acorda o recompensă și oferă fiecărui jucător cel mult o recompensă la 12 ore. Iată un exemplu pentru un server Node.js scris în 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));
}

Livrare și reîncercări

  • Răspunde cu orice status 2xx în maximum 5 secunde.
  • Dacă serverul tău nu răspunde sau returnează o eroare, reîncercăm de până la 3 ori.
  • Voturile fără nume de personaj nu sunt trimise și apar ca „Omis”.
  • Fiecare încercare apare la Voturi recente în panoul tău ca Livrat, Omis sau Eșuat.