For server owners
Add your server, put the vote link on your site and reward your players automatically. Three steps:
1. The vote link
Put this link on your site (SERVER_ID is in My servers):
https://mmotop100.com/vote/SERVER_ID?u=PLAYER_NAME
u = your player's account name (letters, digits, _ . @ -, up to 64). It comes back to you in the postback, so you know whom to reward.
2. How your players get their reward
Postback - we tell your site that the player voted
After every counted vote we call your postback address (POST, form fields):
| Field | Meaning |
|---|---|
| server_id | your server number |
| vote_id | the vote number - unique; reward each vote_id ONCE |
| user | the u from your vote link |
| ip | the voter's IP address |
| country | the voter's country (two letters, may be empty) |
| time | when (unix seconds, UTC) |
| test | 1 = a test from your panel, do not reward |
| sig | signature: HMAC-SHA256 of "vote_id|server_id|user|ip|time" with your postback secret |
Your site reads GET parameters instead? Put placeholders into the address and we send a GET with them filled in: {user} {ip} {vote_id} {server_id} {time} {country} {test} {sig}
https://your-site.com/vote_reward.php?name={user}&ip={ip}&id={vote_id}&t={time}&sig={sig}
Answer with any 2xx status. If your site does not answer, we try again after 1 min, 5 min, 30 min, 2 h and 6 h. Every try is in your postback log.
Example in PHP
<?php
// vote_reward.php - called by MMOTop100 when a player voted
$secret = 'YOUR_POSTBACK_SECRET'; // My servers -> your server -> Keys
$in = $_POST ?: $_GET;
$user = (string)($in['user'] ?? '');
$ip = (string)($in['ip'] ?? '');
$vote = (string)($in['vote_id'] ?? '');
$sid = (string)($in['server_id'] ?? '');
$time = (int)($in['time'] ?? 0);
$sig = (string)($in['sig'] ?? '');
$want = hash_hmac('sha256', "$vote|$sid|$user|$ip|$time", $secret);
if (!hash_equals($want, $sig) || abs(time() - $time) > 86400) { http_response_code(403); exit('bad signature'); }
if (($in['test'] ?? '0') === '1') { exit('OK test'); }
// pay ONCE per vote_id (the same vote can arrive again if your answer got lost):
// INSERT INTO vote_log (vote_id, ...) with vote_id UNIQUE - if it already exists, do nothing.
// then give the reward to $user
echo 'OK';
3. Claim API - the reward of a vote, taken once
For game-server plugins and bots: the first call for a vote returns claimed:true and marks it taken - every later call says it is taken. Ask with the player's IP and/or name.
GET https://mmotop100.com/api/claim?server=SERVER_ID&key=API_KEY&ip=1.2.3.4&user=PLAYER_NAME
{"claimed":true,"vote_id":123,"at":1762900000} = give the reward now (each vote only once)
{"claimed":false,"voted":true,"next":1762943200} = already taken - can vote again at "next"
{"claimed":false,"voted":false} = no vote in the last 12 hours
Or ask us (API)
If your site cannot receive calls, ask whether an IP or a player voted in the last 12 hours:
GET https://mmotop100.com/api/voted?server=SERVER_ID&key=API_KEY&ip=1.2.3.4
GET https://mmotop100.com/api/voted?server=SERVER_ID&key=API_KEY&user=PLAYER_NAME
{"voted":true,"at":1762900000,"next":1762943200} or {"voted":false}
4. Rules
- One vote per server every 12 hours per person (address, browser and player account are all checked).
- Buying votes, vote bots, proxies and forcing players to vote from several connections = the server is removed.
- A sudden flood of votes freezes the server until we check it.
- Your postback address must be public (not 127.0.0.1 or a private network). We never follow redirects.
- Votes from VPNs, proxies, Tor and datacenter addresses are not counted.