Dành cho chủ server
Nút bình chọn & callback.
Đặt nút bình chọn trên website để người chơi bình chọn chỉ với một cú nhấp, rồi thưởng in-game cho họ bằng callback có chữ ký.
Link bình chọn đơn giản
Muốn dùng nút của riêng bạn? Hãy dẫn người chơi thẳng đến trang bình chọn. Cách này hoạt động trên mọi trình duyệt và trên điện thoại.
Link bình chọn
https://mucompass.com/vote/your-serverThưởng người chơi bằng callback
Bật “Thưởng in-game cho người chơi khi họ bình chọn” trong tin đăng và nhập URL callback. Sau mỗi phiếu bầu có tên nhân vật, MU Compass gửi một request POST với body JSON đến URL đó.
Chữ ký là chuỗi hex HMAC-SHA256 của một đối tượng JSON chỉ gồm các trường server, character và votedAt — đúng thứ tự đó và không có khoảng trắng — dùng secret callback của tin đăng làm khóa.
Body callback
Gửi dưới dạng application/json.
{
"server": "ember-realm",
"character": "DarkKnight77",
"votedAt": "2026-10-25T21:42:00.000Z",
"signature": "9f2c6a1d0b7e4c3a8f5d2e1b6a9c0d7e4f3a2b1c8d9e0f7a6b5c4d3e2f1a0b9c"
}Xác minh chữ ký
Luôn xác minh chữ ký trước khi trao thưởng, và mỗi người chơi chỉ nhận tối đa một phần thưởng mỗi 12 giờ. Dưới đây là ví dụ cho server Node.js viết bằng 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));
}Gửi và thử lại
- Trả về bất kỳ mã trạng thái 2xx nào trong vòng 5 giây.
- Nếu server của bạn không phản hồi hoặc trả về lỗi, chúng tôi thử lại tối đa 3 lần.
- Phiếu bầu không có tên nhân vật sẽ không được gửi và hiển thị là “Bỏ qua”.
- Mọi lần gửi đều được liệt kê trong Phiếu gần đây trên bảng điều khiển của bạn với trạng thái Đã gửi, Bỏ qua hoặc Lỗi.