MU Compass

Server sahipleri için

Oy butonu ve callback.

Oyuncuların tek tıkla oy verebilmesi için web sitene bir oy butonu koy, sonra onları imzalı bir callback ile oyun içinde ödüllendir.

Oy butonu ekle

Bir stil seç ve kodu web sitene yapıştır. “your-server” kısmını ilanının adresiyle değiştir — kendi adresinle hazırlanmış kodu sahip panelinde bulabilirsin.

Buton

Kor renginde bir “MU Compass'ta oy ver” butonu.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=button" alt="MU Compass'ta bize oy ver">
</a>

Sıra rozeti

Mevcut aylık sıranı gösterir.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=badge" alt="MU Compass'ta bize oy ver">
</a>

Mini banner

Bağlantı satırları için klasik 88 × 31 buton.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=mini" alt="MU Compass'ta bize oy ver">
</a>

Oyuncuları callback ile ödüllendir

İlanında “Oy veren oyuncuları oyun içinde ödüllendir” seçeneğini aç ve callback URL'ni gir. Karakter adı içeren her oydan sonra MU Compass bu URL'ye JSON gövdeli bir POST isteği gönderir.

İmza, yalnızca server, character ve votedAt alanlarını — bu sırayla ve boşluksuz — içeren bir JSON nesnesinin, anahtar olarak ilanının callback secret'ı kullanılarak hesaplanan hex HMAC-SHA256 değeridir.

Callback gövdesi

application/json olarak gönderilir.

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

İmzayı doğrula

Ödül vermeden önce imzayı her zaman doğrula ve her oyuncuya 12 saatte en fazla bir ödül ver. İşte TypeScript ile yazılmış bir Node.js serverı için bir örnek.

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));
}

İletim ve yeniden denemeler

  • 5 saniye içinde herhangi bir 2xx durum koduyla yanıt ver.
  • Serverın yanıt vermezse ya da hata döndürürse 3 kereye kadar yeniden deneriz.
  • Karakter adı olmayan oylar gönderilmez ve “Atlandı” olarak görünür.
  • Her deneme panelindeki Son oylar bölümünde İletildi, Atlandı ya da Başarısız olarak listelenir.