MU Compass

Dla właścicieli serwerów

Przycisk głosowania i callback.

Umieść przycisk głosowania na swojej stronie, aby gracze mogli głosować jednym kliknięciem, a potem nagradzaj ich w grze dzięki podpisanemu callbackowi.

Dodaj przycisk głosowania

Wybierz styl i wklej kod na swojej stronie. Zamień „your-server” na adres swojego serwera — gotowy kod z Twoim adresem znajdziesz w panelu właściciela.

Przycisk

Ognisty przycisk „Głosuj w MU Compass”.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=button" alt="Zagłosuj na nas w MU Compass">
</a>

Odznaka z miejscem

Pokazuje Twoje aktualne miejsce w miesięcznym rankingu.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=badge" alt="Zagłosuj na nas w MU Compass">
</a>

Mini baner

Klasyczny przycisk 88 × 31 do pasków z linkami.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=mini" alt="Zagłosuj na nas w MU Compass">
</a>

Nagradzaj graczy dzięki callbackowi

Włącz opcję „Nagradzaj graczy w grze za głosowanie” w swoim serwerze i podaj URL callbacku. Po każdym głosie z nazwą postaci MU Compass wysyła na ten URL żądanie POST z treścią JSON.

Podpis to szesnastkowy HMAC-SHA256 obiektu JSON zawierającego tylko pola server, character i votedAt — w tej kolejności i bez spacji — z sekretem callbacku Twojego serwera jako kluczem.

Treść callbacku

Wysyłana jako application/json.

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

Zweryfikuj podpis

Zawsze weryfikuj podpis przed przyznaniem nagrody i dawaj każdemu graczowi maksymalnie jedną nagrodę na 12 godzin. Oto przykład dla serwera Node.js napisanego w 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));
}

Dostarczanie i ponowienia

  • Odpowiedz dowolnym statusem 2xx w ciągu 5 sekund.
  • Jeśli Twój serwer nie odpowie lub zwróci błąd, ponowimy próbę do 3 razy.
  • Głosy bez nazwy postaci nie są wysyłane i mają status „Pominięto”.
  • Każda próba jest widoczna w sekcji Ostatnie głosy w Twoim panelu jako Dostarczono, Pominięto lub Błąd.