MU Compass

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ý.

Thêm nút bình chọn

Chọn một kiểu nút và dán mã vào website của bạn. Thay “your-server” bằng địa chỉ tin đăng của bạn — bạn sẽ tìm thấy mã có sẵn với địa chỉ của riêng bạn trong bảng điều khiển chủ server.

Nút

Nút “Bình chọn trên MU Compass” màu cam lửa.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=button" alt="Bình chọn cho chúng tôi trên MU Compass">
</a>

Huy hiệu hạng

Hiển thị thứ hạng tháng hiện tại của bạn.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=badge" alt="Bình chọn cho chúng tôi trên MU Compass">
</a>

Banner mini

Nút 88 × 31 kinh điển cho hàng liên kết.

<a href="https://mucompass.com/vote/your-server">
  <img src="https://mucompass.com/button/your-server.svg?style=mini" alt="Bình chọn cho chúng tôi trên MU Compass">
</a>

Thưở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.