Владельцам серверов
Добавьте сервер, разместите ссылку для голосования на сайте и награждайте игроков автоматически. Три шага:
1. Ссылка для голосования
Разместите эту ссылку на сайте (SERVER_ID - в разделе Мои серверы):
https://mmotop100.com/vote/SERVER_ID?u=PLAYER_NAME
u = имя аккаунта вашего игрока (буквы, цифры, _ . @ -, до 64). Оно вернётся к вам в postback, чтобы вы знали, кого наградить.
2. Как игроки получают награду
Postback - сообщаем вашему сайту, что игрок проголосовал
После каждого засчитанного голоса мы вызываем ваш адрес postback (POST, поля формы):
| Поле | Значение |
|---|---|
| server_id | номер вашего сервера |
| vote_id | номер голоса - уникальный; награждайте за каждый vote_id ОДИН раз |
| user | u из вашей ссылки для голосования |
| ip | IP-адрес голосующего |
| country | страна голосующего (две буквы, может быть пустой) |
| time | когда (unix-секунды, UTC) |
| test | 1 = тест из вашей панели, не награждать |
| sig | подпись: HMAC-SHA256 от "vote_id|server_id|user|ip|time" с вашим секретом postback |
Ваш сайт читает GET-параметры? Вставьте метки в адрес, и мы отправим GET с заполненными значениями: {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}
Отвечайте любым статусом 2xx. Если ваш сайт не отвечает, мы повторим через 1 мин, 5 мин, 30 мин, 2 ч и 6 ч. Каждая попытка видна в журнале postback.
Пример на 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 - награда за голос, только один раз
Для плагинов игровых серверов и ботов: первый запрос по голосу возвращает claimed:true и отмечает его взятым - все следующие говорят, что он уже взят. Спрашивайте по IP и/или нику игрока.
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
Или спросите нас (API)
Если ваш сайт не может принимать вызовы, спросите, голосовал ли IP или игрок за последние 12 часов:
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. Правила
- Один голос за сервер каждые 12 часов от человека (проверяются адрес, браузер и аккаунт игрока).
- Покупка голосов, боты, прокси и принуждение игроков голосовать с нескольких подключений = сервер удаляется.
- Резкий наплыв голосов замораживает сервер до нашей проверки.
- Адрес postback должен быть публичным (не 127.0.0.1 и не частная сеть). Мы никогда не следуем редиректам.
- Голоса через VPN, прокси, Tor и с адресов дата-центров не засчитываются.