MU Compass

За собственици на сървъри

Бутон за гласуване и callback.

Сложете бутон за гласуване на сайта си, за да гласуват играчите с едно кликване, и ги наградете в играта с подписан callback.

Добавете бутон за гласуване

Изберете стил и поставете кода на сайта си. Заменете „your-server“ с адреса на вашата обява — готовия код с вашия адрес ще намерите в таблото за собственици.

Бутон

Оранжев бутон „Гласувай в MU Compass“.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=button" alt="Гласувайте за нас в MU Compass">
</a>

Значка с място

Показва текущото ви място за месеца.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=badge" alt="Гласувайте за нас в MU Compass">
</a>

Мини банер

Класически бутон 88 × 31 за редове с линкове.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=mini" alt="Гласувайте за нас в MU Compass">
</a>

Наградете играчите с callback

Включете „Награждавай играчите в играта, когато гласуват“ в обявата си и въведете callback адреса си. След всеки глас с име на герой MU Compass изпраща POST заявка с JSON тяло към този адрес.

Подписът е HMAC-SHA256 в шестнадесетичен вид на JSON обект само с полетата server, character и votedAt — в този ред и без интервали — с тайния ключ за callback на обявата ви като ключ.

Тяло на callback

Изпраща се като application/json.

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

Проверете подписа

Винаги проверявайте подписа, преди да дадете награда, и давайте на всеки играч най-много една награда на 12 часа. Ето пример за Node.js сървър, написан на 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));
}

Доставка и повторни опити

  • Отговорете с какъвто и да е 2xx статус до 5 секунди.
  • Ако сървърът ви не отговори или върне грешка, опитваме отново до 3 пъти.
  • Гласовете без име на герой не се изпращат и се показват като „Пропуснат“.
  • Всеки опит се вижда в „Последни гласове“ в таблото ви като Доставен, Пропуснат или Неуспешен.