Владельцам серверов
Кнопка голосования и callback.
Разместите на сайте кнопку голосования, чтобы игроки голосовали в один клик, а затем награждайте их в игре через подписанный callback.
Простая ссылка для голосования
Хотите свою кнопку? Ведите игроков прямо на страницу голосования. Ссылка работает в любом браузере и на мобильных.
Ссылка для голосования
https://mucompass.com/vote/your-serverНаграждайте игроков через 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 раз.
- Голоса без ника персонажа не отправляются и отображаются как «Пропущен».
- Каждая попытка отображается в разделе «Последние голоса» в панели владельца со статусом «Доставлен», «Пропущен» или «Ошибка».