EN
English Български Русский Español Português Türkçe Tiếng Việt 中文 한국어 ไทย Filipino Azərbaycan

For server owners

Add your server, put the vote link on your site and reward your players automatically. Three steps:

Choose your game - this page then shows exactly what to set up for it.

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):

FieldMeaning
server_idyour server number
vote_idthe vote number - unique; reward each vote_id ONCE
userthe u from your vote link
ipthe voter's IP address
countrythe voter's country (two letters, may be empty)
timewhen (unix seconds, UTC)
test1 = a test from your panel, do not reward
sigsignature: 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