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 URL. После каждого голоса с ником персонажа MU Compass отправляет на этот URL POST-запрос с JSON-телом.

Подпись — это HMAC-SHA256 в hex от 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 раз.
  • Голоса без ника персонажа не отправляются и отображаются как «Пропущен».
  • Каждая попытка отображается в разделе «Последние голоса» в панели владельца со статусом «Доставлен», «Пропущен» или «Ошибка».